Microsoft DirectX 8.0 (C++)

IDirectMusicPort8::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
DAUD_PERSIST_VOICE_PRIORITY

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

DAUD_CHAN10_VOICE_PRIORITY_OFFSET
DAUD_CHAN1_VOICE_PRIORITY_OFFSET
DAUD_CHAN2_VOICE_PRIORITY_OFFSET
DAUD_CHAN3_VOICE_PRIORITY_OFFSET
DAUD_CHAN4_VOICE_PRIORITY_OFFSET
DAUD_CHAN5_VOICE_PRIORITY_OFFSET
DAUD_CHAN6_VOICE_PRIORITY_OFFSET
DAUD_CHAN7_VOICE_PRIORITY_OFFSET
DAUD_CHAN8_VOICE_PRIORITY_OFFSET
DAUD_CHAN9_VOICE_PRIORITY_OFFSET
DAUD_CHAN11_VOICE_PRIORITY_OFFSET
DAUD_CHAN12_VOICE_PRIORITY_OFFSET
DAUD_CHAN13_VOICE_PRIORITY_OFFSET
DAUD_CHAN14_VOICE_PRIORITY_OFFSET
DAUD_CHAN15_VOICE_PRIORITY_OFFSET
DAUD_CHAN16_VOICE_PRIORITY_OFFSET

チャンネルの優先順位は、範囲とオフセットを使って表す。たとえば、DAUD_STANDARD_VOICE_PRIORITY と DAUD_CHAN10_VOICE_PRIORITY を組み合わせることで、標準範囲内で最も高い優先順位を表す。標準範囲内の優先順位は、Dmusicc.h 内の DAUD_CHAN1_DEF_VOICE_PRIORITY で始まる定義で表される。

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

動作環境

  ヘッダー : dmusicc.h で宣言。

参照

IDirectMusicPort8::SetChannelPriority