Platform SDK: DirectX

IDirectMusicCollection::GetInstrument

IDirectMusicCollection::GetInstrument メソッドは、パッチ番号を指定して、コレクションから楽器を取り出す。

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

パラメータ

dwPatch
楽器のパッチ番号。
ppInstrument
IDirectMusicInstrument インターフェイスへのポインタを受け取る変数のアドレス。

戻り値

成功すれば 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 で宣言。