midiOutLongMsg
The midiOutLongMsg
function sends a system-exclusive MIDI message to the specified MIDI output
device.
MMRESULT midiOutLongMsg(
|
HMIDIOUT hmo, |
|
|
LPMIDIHDR lpMidiOutHdr, |
|
|
UINT cbMidiOutHdr |
|
|
); |
|
Parameters
hmo
Handle
of the MIDI output device. This parameter can also be the handle of a MIDI
stream cast to HMIDIOUT.
lpMidiOutHdr
Address of a MIDIHDR structure that identifies
the MIDI buffer.
cbMidiOutHdr
Size, in
bytes, of the MIDIHDR structure.
Return Values
Returns
MMSYSERR_NOERROR if successful or an error otherwise. Possible error values
include the following:
|
MIDIERR_NOTREADY |
The
hardware is busy with other data. |
|
MIDIERR_UNPREPARED |
The buffer
pointed to by lpMidiOutHdr has not been prepared. |
|
MMSYSERR_INVALHANDLE |
The
specified device handle is invalid. |
|
MMSYSERR_INVALPARAM |
The
specified pointer or structure is invalid. |
Remarks
Before the
buffer is passed to midiOutLongMsg, it must be prepared by using the midiOutPrepareHeader
function. The MIDI output device driver determines whether the data is sent
synchronously or asynchronously.
See Also