midiOutClose
The midiOutClose function closes the specified MIDI output device.
MMRESULT midiOutClose(
HMIDIOUT hmo
);
Parameters
hmo
Handle to the MIDI output device. If the function is successful, the handle is no longer valid after the call to this function.
Return Values
Returns MMSYSERR_NOERROR if successful or an error otherwise. Possible error values include the following.
| Value | Description |
| MIDIERR_STILLPLAYING | Buffers are still in the queue. |
| MMSYSERR_INVALHANDLE | The specified device handle is invalid. |
| MMSYSERR_NOMEM | The system is unable to load mapper string description. |
Remarks
If there are output buffers that have been sent by using the midiOutLongMsg function and have not been returned to the application, the close operation will fail. To mark all pending buffers as being done, use the midiOutReset function.
Requirements
** Windows NT/2000/XP:** Included in Windows NT 3.1 and later.
** Windows 95/98/Me:** Included in Windows 95 and later.
** Header:** Declared in Mmsystem.h; include Windows.h.
** Library:** Use Winmm.lib.
See Also
Musical Instrument Digital Interface (MIDI), MIDI Functions, midiOutLongMsg, midiOutReset