The WIDM_STOP message requests a waveform input driver to stop recording.
Parameters
uDeviceId
Device identifier (0, 1, 2, and so on) for the target device.
uMsg
WIDM_STOP
dwUser
Device instance identifier.
dwParam1
Not used.
dwParam2
Not used.
Return Value
The driver should return MMSYSERR_NOERROR if the operation succeeds. Otherwise it should return one of the MMSYSERR or WAVERR error codes defined in mmsystem.h. See waveInStop return values in the Win32 SDK.
Comments
A client sends the WIDM_STOP message by calling the user-mode driver's widMessage entry point, passing the specified parameters.
If a buffer in the input queue (see WIDM_ADDBUFFER) has been partially filled, the driver should treat it as a full buffer and return it to the client (see WIDM_START). Empty buffers should remain in the queue.
If this message is received and recording is already stopped, the driver should return MMSYSERR_NOERROR.
Typically, the user-mode driver stops recording by calling DeviceIoControl, sending the kernel-mode driver an IOCTL_WAVE_SET_STATE control code.
For additional information, see Transferring Waveform Input Data.