WIDM_UNPREPARE

Sent to a waveform input device to clean up the preparation performed by the WIDM_PREPARE message.

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	The specified data block is still in the input queue.

DWORD dwParam1: Specifies a far pointer to WAVEHDR structure identifying the data block.
DWORD dwParam2: Specifies the size of the WAVEHDR structure.

Driver support for this message is optional. If a driver supports the WIDM_PREPARE message, then it must also support WIDM_UNPREPARE.

The default response for this message is to return MMSYSERR_NOTSUPPORTED. In this case, MMSYSTEM will clean up the preparation previously done on the memory block. If a driver performs the preparation itself, it must clean up the preparation and reset the WHDR_PREPARED flag in the dwFlags field of the WAVEHDR structure. If a data block has not been prepared, MMSYSERR_NOERROR should be returned.

WIDM_UNPREPARE

See Also