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.
HRESULT AssignPChannel( DWORD dwPChannel, IDirectMusicPort* pPort, DWORD dwGroup, DWORD dwMChannel );
Performance channel to assign.
Pointer to the IDirectMusicPort8 interface of the port to which the channel is assigned.
Channel group on the port.
Channel in the group. Must be in the range from 0 through 15.
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.
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.
** Header:** Dmusici.h
Library: Dmime.dll, Dmimed.dll
- IDirectMusicPerformance8 Interface