midiOutClose

  MMRESULT midiOutClose(hMidiOut)    
  HMIDIOUT hMidiOut;    

The midiOutClose function closes the specified MIDI output device.

Parameters

hMidiOut

Specifies a handle to the MIDI output device. If the function is successful, the handle is no longer valid after this call.

Return Value

Returns zero if the function was successful. Otherwise, it returns an error number. Possible error returns are:

Value Meaning

MMSYSERR_INVALHANDLE Specified device handle is invalid.
MIDIERR_STILLPLAYING There are still buffers in the queue.

Comments

If there are output buffers that have been sent with midiOutLongMsg and haven't been returned to the application,the close operation will fail. Call midiOutReset to mark all pending buffers as being done.

See Also

midiOutOpen, midiOutReset