DirectMusicPerformance8.SendTransposePMSG
転調を開始するためのパフォーマンス メッセージを送信する。
object.SendTransposePMSG( _
lTime As Long, _
flags As Long, _
channel As Long, _
transpose As Integer)
指定項目
- object
- DirectMusicPerformance8 オブジェクトを指定する。
- lTime
- メッセージが演奏されるタイム。flags に DMUS_PMSGF_REFTIME を指定しない限り、このタイムはミュージック タイムで表される。
- flags
- メッセージ処理の方法とタイムを変更するフラグ。「CONST_DMUS_PMSGF_FLAGS」を参照すること。
- channel
- 転調が行われるパフォーマンス チャンネル。複数のチャンネルにメッセージを送信するには、CONST_DMUS_PCHANNEL 列挙型のメンバの 1 つを使用する。
- transpose
- ノートが転置される半音の数。負の値であってもよい。ノートの転調によって、スタンダード MIDI の範囲 0 〜 127 より外側に達した場合は、そのノートは演奏されない。
エラー コード
失敗した場合はエラーが発生し、Err.Number に次のいずれかの値が設定される。
注意
メッセージのタイムが 0、flags パラメータに DMUS_PMSGF_REFTIME が設定されている場合は、メッセージが挿入されて即座に送り出される。