Platform SDK: DirectX |
IDirectMusicCollection::GetInstrument メソッドは、パッチ番号を指定して、コレクションから楽器を取り出す。
HRESULT GetInstrument( DWORD dwPatch, IDirectMusicInstrument** ppInstrument );
成功すれば S_OK を返す。
失敗すれば次のエラー値のいずれかを返す。
DMUS_E_CORE_INVALIDPATCH |
E_FAIL |
E_OUTOFMEMORY |
E_POINTER |
dwPatch で渡されたパッチ番号は、バンク セレクトの MSB と LSB の MIDI パラメータも含む、完全なパッチアドレスを記述する。MSB は左シフトされた 16 ビットであり、LSB は左シフトされた 8 ビットである。詳細は、「 MIDI チャンネル メッセージ」を参照すること。
加えて、特に音色がドラム キットであり、MIDI チャンネル 10 で演奏されることを意図している場合は、上位ビット (0x80000000) をセットしなければならない。DLS レベル 1 用のこの特別なタグは、ドラムを必ず MIDI チャンネル 10 に置く。
このメソッドを使う方法の詳細については、「音色の操作」を参照すること。
Windows NT/2000 : Windows 2000 が必要。
Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
ヘッダー : dmusicc.h で宣言。