Microsoft DirectX 8.0 (C++)

IDirectMusicCollection8::GetInstrument

パッチ番号を指定して、コレクションから音色を取得する。

HRESULT GetInstrument(
  DWORD dwPatch,
  IDirectMusicInstrument** ppInstrument
);

パラメータ

dwPatch
音色のパッチ番号。
ppInstrument
IDirectMusicInstrument8 インターフェイス ポインタを受け取る変数のアドレス。

戻り値

成功した場合は 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 で宣言。