Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

                                                 ◄Contents► ◄Index► ◄Back►
────────────────────────────────────────────────────────────────────────────
WIDM_RESET
 
        This message is sent to waveform input device drivers to stop
        waveform recording and return all buffers in the input queue to
        the client.
 
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
        The driver should stop recording even if in the paused state. It
        should set the WHDR_DONE bit and clear the WHDR_INQUEUE bit in
        the dwFlags field of the WAVEHDR structure for each buffer in the
        input queue. It should also be sure the dwBytesRecorded field
        contains the number of bytes recorded for each buffer and reset the
        position count to zero. The driver should then notify the client by
        using DriverCallback to send a WOM_DONE message for each
        buffer.
 
See also
        WIDM_STOP
 
                                       -♦-