WIDM_UNPREPARE

This message is sent to a waveform input device to clean up the preparation performed by the WIDM_PREPARE message.

Parameters

DWORD dwParam1

Specifies a far pointer to WAVEHDR structure identifying the data block.

DWORD dwParam2

Specifies the size of the WAVEHDR structure.

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

The specified data block is still in the input queue.

Comments

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.

See Also

WIDM_PREPARE