Microsoft DirectX 8.0 (C++) |
音色のパッチ番号を取得する。このパッチ番号は、バンク セレクトの MSB と LSB、および MIDI パッチ (プログラム チェンジ) 番号によって構成されたアドレスである。オプションのフラグ ビットは、音色が旋律系の音色ではなく、ドラムであることを表す。
HRESULT GetPatch( DWORD* pdwPatch );
成功した場合は S_OK を返す。
失敗した場合は、次のいずれかのエラー値を返す。
DMUS_E_NOT_INIT |
E_POINTER |
pdwPatch に返されるパッチ番号は、バンク セレクトの MSB と LSB の MIDI パラメータも含む、完全なパッチ番号を表す。加えて、特に音色がドラム キットであり、MIDI チャンネル 10 で演奏されることを意図している場合は、上位ビットが設定される。DLS レベル 1 はドラムを必ず MIDI チャンネル 10 で演奏するため、これが DLS レベル 1 用の特別なタグである。詳細については、「MIDI チャンネル メッセージ」を参照すること。
ヘッダー : dmusicc.h で宣言。