IDirectMusicPerformance::AssignPChannelBlock
This method assigns a block of 16 performance channels (PChannels) to the performance and maps them to a port and a channel group. This method must be called when a port has been added to a performance, except when the default port has been added by passing NULL to IDirectMusicPerformance::AddPort.
HRESULT AssignPChannelBlock(
DWORD dwBlockNum,
IDirectMusicPort* pPort,
DWORD dwGroup
);
Parameters
- dwBlockNum
Block number, in which 0 represents channels 0 through 15, 1 represents channels 16 through 31, and so on. - pPort
Address of a variable that contains the port to which the channels are assigned. - dwGroup
Channel group on the port. Must be 1 or greater.
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 following error values:
E_INVALIDARG |
E_POINTER |
Remarks
The method returns S_FALSE if dwGroup is out of the range of the port. The channels have been assigned, but the port cannot play this group.
The method returns E_INVALIDARG if the port has not been added to the performance through a call to the IDirectMusicPerformance::AddPort method.
Requirements
OS Versions: Windows CE .NET 4.0 and Windows CE .NET 4.1.
Header: Dmusici.h.
Link Library: Dmusic.lib.
See Also
Channels | IDirectMusicPerformance::AddPort | IDirectMusicPerformance::AssignPChannel | IDirectMusicPerformance::PChannelInfo
Last updated on Monday, April 12, 2004
© 1992-2002 Microsoft Corporation. All rights reserved.