Platform SDK: DirectX

DirectMusicPerformance.SendNotePMSG

The DirectMusicPerformance.SendNotePMSG method sends a performance message containing information about a note.

object.SendNotePMSG(lTime As Long, _
    flags As Long, _
    channel As Long, _
    msg As DMUS_NOTE_PMSG)

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
Performance channel that is the destination for the message.
msg
DMUS_NOTE_PMSG type containing information about the note.

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, it is assumed that this message is cued to go out immediately.

See Also

Music Values and MIDI Notes