Platform SDK: DirectX

DirectMusicPerformance.SendMIDIPMSG

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

object.SendMIDIPMSG(lTime As Long, _
    flags As Long, _
    channel As Long, _
    status As Byte, _
    byte1 As Byte, _
    byte2 As Byte)

パラメータ

object
DirectMusicPerformance オブジェクトを表すオブジェクト式。
lTime
メッセージが演奏されるタイム。flags に DMUS_PMSGF_REFTIME を指定しない限り、このタイムはミュージック タイムで表される。
flags
メッセージ処理の方法とタイムを変更するフラグ。「CONST_DMUS_PMSGF_FLAGS」を参照すること。
channel
メッセージの送信先となるパフォーマンス チャンネル。
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 規格を参照すること。