IDirectMusicPerformance8::PChannelInfo
The PChannelInfo method retrieves the port, group, and MIDI channel for a given performance channel .
Syntax
HRESULT PChannelInfo(
DWORD dwPChannel,
IDirectMusicPort** ppPort,
DWORD* pdwGroup,
DWORD* pdwMChannel
);
Parameters
dwPChannel
Performance channel for which information is desired.
ppPort
Address of a variable that receives an IDirectMusicPort8 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 Remarks.
pdwGroup
Address of a variable that receives the group on the port. Can be NULL if this value is not wanted.
pdwMChannel
Address of a variable that receives 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 error values shown in the following table.
Return code |
E_INVALIDARG |
E_POINTER |
Remarks
A NULL pointer is returned in *ppPort if the port has been removed by a call to IDirectMusicPerformance8::RemovePort, but the method succeeds.
Requirements
** Header:** Dmusici.h
Library: Dmime.dll, Dmimed.dll
See Also