| Microsoft DirectX 9.0 SDK Update (Summer 2004) |
IDirectMusicPerformance8::PChannelInfo
The PChannelInfo method retrieves the port, group, and MIDI channel for a given
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: Declared in dmusici.h.
See Also
- IDirectMusicPerformance8 Interface
- IDirectMusicPerformance8::AssignPChannel
- IDirectMusicPerformance8::AssignPChannelBlock
© 2004 Microsoft Corporation. All rights reserved.