Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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