IDirectMusicSynth::GetChannelPriority method (dmusics.h)

The GetChannelPriority method outputs the priority of a MIDI channel.

Syntax

HRESULT GetChannelPriority(
  DWORD   dwChannelGroup,
  DWORD   dwChannel,
  LPDWORD pdwPriority
);

Parameters

dwChannelGroup

Specifies the channel group that the channel belongs to. This parameter must be one or greater.

dwChannel

Specifies the index of the channel in the channel group. This is a value in the range 0 to 15.

pdwPriority

Output pointer for the priority ranking. This parameter points to a caller-allocated variable into which the method writes the priority ranking value. For a list of the priority values that are defined for this parameter, see the IDirectMusicPort::GetChannelPriority reference page in the Microsoft Windows SDK documentation.

Return value

GetChannelPriority returns S_OK if the call was successful. Otherwise, the method returns an appropriate error code.

Remarks

This method is used with the IDirectMusicSynth::SetChannelPriority method to control the channel priorities and facilitate correct voice stealing.

For more information, see the descriptions of the IDirectMusicPort::GetChannelPriority and IDirectMusicPort::SetChannelPriority methods in the Windows SDK documentation.

Requirements

See also

IDirectMusicSynth::SetChannelPriority