midiInStop

  MMRESULT midiInStop(hMidiIn)    
  HMIDIIN hMidiIn;    

The midiInStop function terminates MIDI input on the specified MIDI input device.

Parameters

hMidiIn

Specifies a handle to the MIDI input device.

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.

Comments

Current status (running status, parsing state, etc.) is maintained across calls to midiInStop and midiInStart. If there are any system-exclusive message buffers in the queue,the current buffer is marked as done (the dwBytesRecorded field in the header will contain the actual length of data), but any empty buffers in the queue remain there. Calling this function when input is not started has no no effect, and the function returns zero.

See Also

midiInStart, midiInReset