IDirectMusicPerformance::PChannelInfo

  • Article

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.