 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
This message is used in an MMDRV_MESSAGE_PARAMSstructure passed to the WAV_IOControlfunction to request a waveform input driver to close a specified device instance previously opened with WIDM_OPEN.
Parameters
- uDeviceId
- Device identifier — 0, 1, 2, and so on — for the target device.
- uMsg
- Specifies this message.
- dwUser
- Specifies a device instance identifier.
- dwParam1
- Not used.
- dwParam2
- Not used.
Return Values
MMSYSERR_NOERROR indicates success. Otherwise, the driver returns one of the MMSYSERR or WAVERR error values declared in the Mmsystem.h header file.
Remarks
The ACM (Waveapi.dll) sends the WIDM_CLOSE message by calling the audio driver's (Wavedev.dll) WAV_IOControlentry point through the DeviceIoControlfunction.
If the driver has not filled and returned all the buffers received with WIDM_ADDBUFFER messages, it does not close the instance. Instead, it returns WAVERR_STILLPLAYING.
After the driver closes the device instance, it sends a WIM_CLOSE callback message to the ACM.
Requirements
Runs on Versions Defined in Include Link to Windows CE OS 1.0 and later Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.
Last updated on Tuesday, July 13, 2004