Microsoft DirectX 8.0 (Visual Basic)

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 に次のいずれかの値が設定される。

DMUS_E_NO_MASTER_CLOCK
DMUS_E_ALREADY_SENT
DMUS_E_INVALIDARG

注意

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