Platform SDK: DirectX

DirectMusicPerformance.SendTransposePMSG

DirectMusicPerformance.SendTransposePMSG メソッドは、転調を開始させるパフォーマンス メッセージを送信する。

object.SendTransposePMSG(lTime As Long, _
    flags As Long, _
    channel As Long, _
    transpose As Integer)

パラメータ

object
DirectMusicPerformance オブジェクトを表すオブジェクト式。
lTime
メッセージが演奏されるタイム。flags に DMUS_PMSGF_REFTIME を指定しない限り、このタイムはミュージック タイムで表される。
flags
メッセージ処理の方法とタイムを変更するフラグ。「CONST_DMUS_PMSGF_FLAGS」を参照すること。
channel
転調が行われる P チャンネル
transpose
音符が転調される半音の数。負の値であってもよい。音符の転調によって、スタンダード MIDI の範囲 0 〜 127 より外側に達した場合は、その音符は演奏されない。

エラー コード

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

DMUS_E_NO_MASTER_CLOCK
DMUS_E_ALREADY_SENT
DMUS_E_INVALIDARG

注意

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