Edit

midiOutLongMsg function (mmeapi.h)

  • Article

The midiOutLongMsg function sends a system-exclusive MIDI message to the specified MIDI output device.

Syntax

MMRESULT midiOutLongMsg(
  HMIDIOUT  hmo,
  LPMIDIHDR pmh,
  UINT      cbmh
);

Parameters

hmo

Handle to the MIDI output device. This parameter can also be the handle of a MIDI stream cast to HMIDIOUT.

pmh

Pointer to a MIDIHDR structure that identifies the MIDI buffer.

cbmh

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

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header mmeapi.h (include Windows.h)
Library Winmm.lib
DLL Winmm.dll

See also

MIDI Functions