IDirectMusicSegment8::SetPChannelsUsed

The SetPChannelsUsed method 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.

Syntax

HRESULT SetPChannelsUsed(
  DWORD dwNumPChannels,
  DWORD* paPChannels
);

Parameters

dwNumPChannels

Number of performance channels to set. This must be equal to the number of members in the array pointed to by paPChannels.

paPChannels

Address of an array of performance channel identifiers.

Return Values

If the method succeeds, the return value is S_OK.

If it fails, the method can return one of the error values shown in the following table.

Remarks

This method enables the performance to ascertain 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

• Channels
• IDirectMusicSegment8
• Latency and Bumper Time