MIDM_STOP

This message is sent to a MIDI input device driver to end recording of incoming MIDI data.

Parameters

DWORD dwParam1

Unused.

DWORD dwParam2

Unused.

Return Value

The return value is an error code, or zero (MMSYSERR_NOERROR) if the operation is successful. Possible error codes are:

MMSYSERR_NOTENABLED

The driver failed to load or initialize.

Comments

If there is a buffer in the input queue that contains any system-exclusive data, the driver should set the MHDR_DONE bit and clear the MHDR_INQUEUE bit in the dwFlags field of the MIDIHDR structure identifying the buffer. It should then put the number of actual bytes recorded in the dwBytesRecorded field and return the buffer to the client by sending a MIM_LONGDATA message with the DriverCallback function. Any empty buffers should remain in the queue.

While recording is stopped, the driver should maintain the current MIDI status byte for running status events and the parsing state for multi-byte events. If this message is received and recording is already stopped, the driver should return MMSYSERR_NOERROR.

See Also

MIDM_START, MIDM_RESET