Platform SDK: DirectX

DirectMusicPerformance.SendPatchPMSG

The DirectMusicPerformance.SendPatchPMSG method sends a performance message containing information about a MIDI patch change.

object.SendPatchPMSG(lTime As Long, _
    flags As Long, _
    channel As Long, _
    instrument As Byte, _
    byte1 As Byte, _
    byte2 As Byte)

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.
instrument
Patch number to assign to the channel.
byte1
Most significant byte of bank select.
byte2
Least significant byte of bank select.

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.