Microsoft DirectX 8.0 (Visual Basic)

DirectMusicPerformance8.SendPatchPMSG

MIDI パッチ変更に関する情報を保持するパフォーマンス メッセージを送信する。

object.SendPatchPMSG( _
  lTime As Long, _
  flags As Long, _
  channel As Long, _
  instrument As Byte, _
  byte1 As Byte, _
  byte2 As Byte)

指定項目

object
DirectMusicPerformance8 オブジェクトを指定する。
lTime
メッセージが演奏されるタイム。flags に DMUS_PMSGF_REFTIME を指定しない限り、このタイムはミュージック タイムで表される。
flags
メッセージ処理の方法とタイムを変更するフラグ。「CONST_DMUS_PMSGF_FLAGS」を参照すること。
channel
メッセージの送信先となるパフォーマンス チャンネル。複数のチャンネルにメッセージを送信するには、CONST_DMUS_PCHANNEL 列挙型のメンバの 1 つを使用する。
instrument
チャンネルに割り当てるパッチ番号。
byte1
バンク セレクトの上位バイト。
byte2
バンク セレクトの下位バイト。

エラー コード

失敗した場合はエラーが発生し、Err.Number に次のいずれかの値が設定される。

DMUS_E_NO_MASTER_CLOCK
DMUS_E_ALREADY_SENT
DMUS_E_INVALIDARG

注意

メッセージのタイムが 0、flags パラメータに DMUS_PMSGF_REFTIME が設定されている場合は、メッセージが挿入されて即座に送り出される。