IDirectMusicPerformance::PChannelInfo
This method retrieves the port, group, and MIDI channel for a given performance channel.
HRESULT PChannelInfo(
DWORD dwPChannel,
IDirectMusicPort** ppPort,
DWORD* pdwGroup,
DWORD* pdwMChannel
);
Parameters
- dwPChannel
PChannel for which information is desired. - ppPort
Address of a variable to receive an IDirectMusicPort pointer. This value can be NULL if the pointer is not wanted. If a non-NULL pointer is returned, the reference count is incremented, and it is the responsibility of the application to call Release on the pointer. See also Remarks. - pdwGroup
Address of a variable to receive the group on the port. Can be NULL if this value is not wanted. - pdwMChannel
Address of a variable to receive the MIDI channel on the group. Can be NULL if this value is not wanted.
Return Values
If the method succeeds, the return value is S_OK.
If it fails, the method can return one of the following error values:
E_INVALIDARG |
E_POINTER |
Remarks
A NULL pointer is returned in *ppPort if the port has been removed by a call to IDirectMusicPerformance::RemovePort, but the method succeeds.
Requirements
OS Versions: Windows CE .NET 4.0 and Windows CE .NET 4.1.
Header: Dmusici.h.
Link Library: Dmusic.lib.
See Also
IDirectMusicPort | IDirectMusicPerformance::AssignPChannel | IDirectMusicPerformance::AssignPChannelBlock | IDirectMusicPerformance::RemovePort
Last updated on Monday, April 12, 2004
© 1992-2002 Microsoft Corporation. All rights reserved.