Microsoft DirectX 8.1 (Visual Basic) |
The 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)
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
instrument
Patch number to assign to the channel.
byte1
Most significant byte of the
byte2
Least significant byte of the 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, the message is cued to go out immediately.