DirectMusicPerformance.SendTransposePMSG

The DirectMusicPerformance.SendTransposePMSG method sends a performance message causing a transposition to begin.

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

Parameters

object

Object expression that resolves to a DirectMusicPerformance object.

lTime

Time at which the message is to play. This is in music time unless DMUS_PMSGF_REFTIME is in flags.

flags

Flags modifying how and when the message is processed. See CONST_DMUS_PMSGF_FLAGS.

channel

Pchannel on which the transposition is to take place.

transpose

Number of semitones by which to transpose notes. This can be a negative value. If the transposition of a note puts it outside the standard MIDI range from 0 through 127, it does not play.

Error Codes

If the method fails, it raises an error, and Err.Number can be set to one of the following values:

Remarks

If the time of the message is set to 0 and the flags parameter contains DMUS_PMSGF_REFTIME, it is assumed that this message is cued to go out immediately.