IDirectMusicPerformance8::AssignPChannel

^{IDirectMusicPerformance8::AssignPChannel}

The AssignPChannel method assigns a single performance channel to the performance and maps it to a port, group, and MIDI channel.

This method is not used by applications that route their data through audiopaths.

Syntax

HRESULT AssignPChannel(
  DWORD dwPChannel, 
  IDirectMusicPort* pPort,
  DWORD dwGroup, 
  DWORD dwMChannel
);

Parameters

dwPChannel

Performance channel to assign.

pPort

Pointer to the IDirectMusicPort8 interface of the port to which the channel is assigned.

dwGroup

Channel group on the port.

dwMChannel

Channel in the group. Must be in the range from 0 through 15.

Return Values

If the method succeeds, the return value is S_OK, or S_FALSE (see Remarks).

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

Remarks

The method returns S_FALSE if dwGroup is out of the range of the port. The channel has been assigned, but the port cannot play this group.

The method returns E_INVALIDARG if dwMChannel is out of range or the port has not been added to the performance through a call to the IDirectMusicPerformance8::AddPort method.

Requirements

  Header: Declared in dmusici.h.

See Also

• Channels
• IDirectMusicPerformance8 Interface
• IDirectMusicPerformance8::AssignPChannelBlock
• IDirectMusicPerformance8::PChannelInfo