Platform SDK: DirectX |
The IDirectMusicPerformance::AssignPChannel method assigns a single performance channel (PChannel) to the performance and maps it to a port, group, and MIDI channel.
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 IDirectMusicPerformance::AddPort method.
Windows NT/2000: Requires Windows 2000.
Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
Header: Declared in dmusici.h.
IDirectMusicPerformance::AssignPChannelBlock, IDirectMusicPerformance::PChannelInfo, Channels