Microsoft DirectX 8.0 (C++)

IDirectMusicInstrument8::GetPatch

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

HRESULT GetPatch(
  DWORD* pdwPatch
);

パラメータ

pdwPatch
パッチ番号を受け取る変数のアドレス。

戻り値

成功した場合は S_OK を返す。

失敗した場合は、次のいずれかのエラー値を返す。

DMUS_E_NOT_INIT
E_POINTER

注意

pdwPatch に返されるパッチ番号は、バンク セレクトの MSB と LSB の MIDI パラメータも含む、完全なパッチ番号を表す。加えて、特に音色がドラム キットであり、MIDI チャンネル 10 で演奏されることを意図している場合は、上位ビットが設定される。DLS レベル 1 はドラムを必ず MIDI チャンネル 10 で演奏するため、これが DLS レベル 1 用の特別なタグである。詳細については、「MIDI チャンネル メッセージ」を参照すること。

動作環境

  ヘッダー : dmusicc.h で宣言。