Platform SDK: DirectX

IDirectMusicPort::GetChannelPriority

IDirectMusicPort::GetChannelPriority メソッドは、MIDI チャンネルの優先順位を取り出すために使われる。概要については、「チャンネル」を参照すること。

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

パラメータ

dwChannelGroup
チャンネルが置かれているグループ。
dwChannel
グループ内のチャンネルのインデックス。
pdwPriority
優先順位を受け取る変数のアドレス。「注意」を参照すること。

戻り値

成功すれば S_OK。

注意

Dmusicc.h 内で定義されている以下の値は、それぞれ優先順位の範囲を表す。優先順位の高いものから順にリストする。

DAUD_CRITICAL_VOICE_PRIORITY
DAUD_HIGH_VOICE_PRIORITY
DAUD_STANDARD_VOICE_PRIORITY
DAUD_LOW_VOICE_PRIORITY

以下の値は、DLS レベル 1 標準による、範囲内におけるチャンネルのデフォルト順位を表す。優先順位の高いものから順にリストする。パーカッション チャンネルのチャンネル 10 が、最も優先順位が高い。

DAUD_CHAN10_DEF_VOICE_PRIORITY_OFFSET
DAUD_CHAN1_DEF_VOICE_PRIORITY_OFFSET
DAUD_CHAN2_DEF_VOICE_PRIORITY_OFFSET
DAUD_CHAN3_DEF_VOICE_PRIORITY_OFFSET
DAUD_CHAN4_DEF_VOICE_PRIORITY_OFFSET
DAUD_CHAN5_DEF_VOICE_PRIORITY_OFFSET
DAUD_CHAN6_DEF_VOICE_PRIORITY_OFFSET
DAUD_CHAN7_DEF_VOICE_PRIORITY_OFFSET
DAUD_CHAN8_DEF_VOICE_PRIORITY_OFFSET
DAUD_CHAN9_DEF_VOICE_PRIORITY_OFFSET
DAUD_CHAN11_DEF_VOICE_PRIORITY_OFFSET
DAUD_CHAN12_DEF_VOICE_PRIORITY_OFFSET
DAUD_CHAN13_DEF_VOICE_PRIORITY_OFFSET
DAUD_CHAN14_DEF_VOICE_PRIORITY_OFFSET
DAUD_CHAN15_DEF_VOICE_PRIORITY_OFFSET
DAUD_CHAN16_DEF_VOICE_PRIORITY_OFFSET

チャンネルの優先順位は、範囲とオフセットを使って表す。たとえば、DAUD_STANDARD_VOICE_PRIORITY と DAUD_CHAN10_DEF_VOICE_PRIORITY で、標準範囲内で最も高い優先順位を表す。

同じ優先順位値を持つチャンネルは、所属するチャンネル グループの種類に関係なく、同じ優先順位を持つ。

動作環境

  Windows NT/2000 : Windows 2000 が必要。
  Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
  ヘッダー : dmusicc.h で宣言。

参照

IDirectMusicPort::SetChannelPriority