Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

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 codeDescription
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

See also

MIDI Functions

 

 

Show: