Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The midiOutReset function turns off all notes on all MIDI channels for the specified MIDI output device.
Syntax
MMRESULT midiOutReset(
HMIDIOUT hmo
);
Parameters
hmo
Handle to the MIDI output device. This parameter can also be the handle of a MIDI stream cast to HMIDIOUT.
Return value
Returns MMSYSERR_NOERROR if successful or an error otherwise. Possible error values include the following.
| Return code | Description |
|---|---|
|
The specified device handle is invalid. |
Remarks
Any pending system-exclusive or stream output buffers are returned to the callback function and the MHDR_DONE flag is set in the dwFlags member of the MIDIHDR structure.
Terminating a system-exclusive message without sending an EOX (end-of-exclusive) byte might cause problems for the receiving device. The midiOutReset function does not send an EOX byte when it terminates a system-exclusive message - applications are responsible for doing this.
To turn off all notes, a note-off message for each note in each channel is sent. In addition, the sustain controller is turned off for each channel.
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 |