See also WODM_UNPREPARE
Sent to a waveform output device driver to request the driver to prepare a data block for playback. If data blocks are accessed at interrupt time, they must be page locked to ensure that the memory is not swapped out to disk.
MMSYSERR_NOTENABLED | The driver failed to load or initialize. |
MMSYSERR_NOTSUPPORTED | The driver does not support this message. |
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 this message, then it must also support WODM_UNPREPARE.
The default response for this message is to return MMSYSERR_NOTSUPPORTED. In this case, MMSYSTEM will page lock the memory for the driver. If a driver requires other operations to prepare a data block for playback, it should set the WHDR_PREPARED bit in the dwFlags field of the WAVEHDR structure and return MMSYSERR_NOERROR. In this case, MMSYSTEM assumes the driver has prepared the data block and does not page lock the memory. If a data block has already been prepared, MMSYSERR_NOERROR should be returned.