Platform SDK: DirectX

IDirectMusicInstrument::GetPatch

IDirectMusicInstrument::GetPatch メソッドは、楽器のパッチ番号を取り出す。このパッチ番号は、バンク セレクトの MSB と LSB、および MIDI パッチ (プログラムチェンジ) 番号によって構成されたアドレスである。オプションのフラグ ビットは、音色が旋律系の音色ではなく、ドラムであることを表す。

HRESULT GetPatch(
  DWORD* pdwPatch
);

パラメータ

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 で宣言。