Microsoft DirectX 8.0 (Visual Basic)

DirectMusicPerformance8.SendMIDIPMSG

その他のメソッドによって処理されない MIDI チャンネル メッセージに関する情報を含むパフォーマンス メッセージを送信する。

object.SendMIDIPMSG( _
    lTime As Long, _
    flags As Long, _
    channel As Long, _
    status 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 つを使用する。
status
スタンダード MIDI のステータス バイト。「注意」を参照すること。
byte1
先頭のデータ バイト。これを必要としない MIDI メッセージでは無視される。
byte2
2 番目のデータ バイト。これを必要としない MIDI メッセージでは無視される。

エラー コード

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

DMUS_E_NO_MASTER_CLOCK
DMUS_E_ALREADY_SENT
DMUS_E_INVALIDARG

注意

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

チャンネルは別のパラメータ内で指定されるため、スタンダード MIDI メッセージの場合とは異なり、status の下位 4 ビットにはチャンネル番号が含まれない。したがって、status はノートオフの場合に &H80、ノートオンの場合に &H90 などとなる。その他のステータス バイトについては、MIDI 規格を参照すること。