Microsoft DirectX 8.0 (C++)

IDirectMusicSegment8::SetPChannelsUsed

Sets the performance channels that this segment uses. This method is usually called by a track in the IDirectMusicTrack8::Init method to inform the segment of which channels the track uses.

HRESULT SetPChannelsUsed(
  DWORD dwNumPChannels,
  DWORD* paPChannels
);

Parameters

dwNumPChannels
Number of PChannels to set. This must be equal to the number of members in the array pointed to by paPChannels.
paPChannels
Address of an array of PChannels.

Return Values

If the method succeeds, the return value is S_OK.

If it fails, the method can return one of the following error values:

E_INVALIDARG
E_OUTOFMEMORY
E_POINTER

Remarks

This method allows the performance to know which ports are being used by the segment so that it can determine the actual latency, rather than providing for the worst case.

Requirements

  Header: Declared in dmusici.h.

See Also

Latency and Bumper Time, Channels