Platform SDK: DirectX |
IDirectMusicInstrument::GetPatch メソッドは、楽器のパッチ番号を取り出す。このパッチ番号は、バンク セレクトの MSB と LSB、および MIDI パッチ (プログラムチェンジ) 番号によって構成されたアドレスである。オプションのフラグ ビットは、音色が旋律系の音色ではなく、ドラムであることを表す。
HRESULT GetPatch( DWORD* pdwPatch );
成功すれば S_OK を返す。
失敗すれば E_POINTER を返す。
pdwPatch に返されるパッチ番号は、バンク セレクトの MSB と LSB の MIDI パラメータも含む、完全なパッチ番号を記述する。加えて、特に音色がドラム キットであり、MIDI チャンネル 10 で演奏されることを意図している場合は、上位ビットがセットされる。DLS レベル 1 はドラムを必ず MIDI チャンネル 10 で演奏するため、これが DLS レベル 1 用の特別なタグである。詳細については、「MIDI チャンネル メッセージ」を参照すること。
Windows NT/2000 : Windows 2000 が必要。
Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
ヘッダー : dmusicc.h で宣言。