Microsoft DirectX 8.0 (C++) |
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 );
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 following error values:
E_INVALIDARG |
E_POINTER |
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: Declared in dmusici.h.
IDirectMusicPerformance8::AssignPChannelBlock, IDirectMusicPerformance8::PChannelInfo, Channels