midiOutLongMsg function
The midiOutLongMsg function sends a system-exclusive MIDI message to the specified MIDI output device.
Syntax
MMRESULT midiOutLongMsg(
HMIDIOUT hmo,
LPMIDIHDR lpMidiOutHdr,
UINT cbMidiOutHdr
);
Parameters
hmo
Handle to the MIDI output device. This parameter can also be the handle of a MIDI stream cast to HMIDIOUT.lpMidiOutHdr
Pointer to a MIDIHDR structure that identifies the MIDI buffer.cbMidiOutHdr
Size, in bytes, of the MIDIHDR structure.
Return value
Returns MMSYSERR_NOERROR if successful or an error otherwise. Possible error values include the following.
| Return code | Description |
|---|---|
| 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.
Requirements
Minimum supported client |
Windows 2000 Professional [desktop apps only] |
Minimum supported server |
Windows 2000 Server [desktop apps only] |
Header |
Mmsystem.h (include Windows.h) |
Library |
Winmm.lib |
DLL |
Winmm.dll |