Microsoft DirectX 8.1 (Visual Basic)

DirectMusicPerformance8.SendTempoPMSG

The SendTempoPMSG method sends a performance message containing information about a tempo change.

object.SendTempoPMSG( _
  lTime As Long, _
  flags As Long, _
  tempo As Double)

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.

tempo

New tempo, in beats per minute.

Error Codes

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

DMUS_E_NO_MASTER_CLOCK
DMUS_E_ALREADY_SENT
DMUS_E_INVALIDARG

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.