◄Contents► ◄Index► ◄Back►
────────────────────────────────────────────────────────────────────────────
WODM_UNPREPARE
 
        This message is sent to a waveform output device to clean up the
        preparation performed by the WODM_PREPARE message. If a driver
        supports this message, then it must also support WODM_PREPARE.
 
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 output queue.
 
Comments
        Driver support for this message is optional. If a driver
        supports the WODM_PREPARE message, then it must also support
        WODM_UNPREPARE.
 
        The default response for this message is to do nothing but
        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
        WODM_PREPARE
 
                                       -♦-