Microsoft DirectX 8.0 (C++) |
パッチ番号を指定して、コレクションから音色を取得する。
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) が設定される。
このメソッドを使う方法の詳細については、「音色の操作」を参照すること。
ヘッダー : dmusicc.h で宣言。