DirectMusicPerformance8.SendTransposePMSG
Sends a performance message causing a transposition to begin.
object.SendTransposePMSG( _
lTime As Long, _
flags As Long, _
channel As Long, _
transpose As Integer)
Parts
- object
- Resolves to a DirectMusicPerformance8 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
- Performance channel on which the transposition is to take place. To send the message to more than one channel, use one of the members of the CONST_DMUS_PCHANNEL enumeration.
- 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, the message is cued to go out immediately.