Windows Multimedia DDK (mddkqh.hlp) (Table of Contents; Topic list)
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.
WIDM_CLOSE
                                                 Contents Index Back
────────────────────────────────────────────────────────────────────────────
WIDM_CLOSE
 
        This message is sent to a waveform input device driver to
        deallocate a specified device.
 
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.
 
        WAVERR_STILLPLAYING
            There are still buffers in the queue.
 
Comments
        If there are input buffers that haven't been returned to the
        application, the driver should fail the operation and return
        WAVERR_STILLPLAYING. If the close operation is successful,
        the driver should use the DriverCallback function to send the
        client a WIM_CLOSE message.
 
See also
        WIDM_OPEN
 
                                       -♦-