Platform SDK: DirectX

DirectMusicPerformance.SendPatchPMSG

DirectMusicPerformance.SendPatchPMSG メソッドは、MIDI パッチの変更に関する情報を含むパフォーマンス メッセージを送信する。

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

パラメータ

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

エラー コード

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

DMUS_E_NO_MASTER_CLOCK
DMUS_E_ALREADY_SENT
DMUS_E_INVALIDARG

注意

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