Platform SDK: DirectX |
IDirectMusicPort::GetChannelPriority メソッドは、MIDI チャンネルの優先順位を取り出すために使われる。概要については、「チャンネル」を参照すること。
HRESULT GetChannelPriority( DWORD dwChannelGroup, DWORD dwChannel, LPDWORD 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 で宣言。