IDirectMusicPort::SetChannelPriority

The IDirectMusicPort::SetChannelPriority method is used to set the priority of a MIDI channel. For an overview, see Channels.

HRESULT SetChannelPriority(
  DWORD  dwChannelGroup, 
  DWORD  dwChannel, 
  DWORD  dwPriority
);

Parameters

dwChannelGroup

Group that the channel is in. This value must be 1 or greater.

dwChannel

Index of the channel on the group.

dwPriority

The priority ranking. See Remarks for IDirectMusicPort::GetChannelPriority.

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:

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in dmusicc.h.

See Also

IDirectMusicPort::GetChannelPriority, DMUS_CHANNEL_PRIORITY_PMSG.