Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

                                                 ◄Contents► ◄Index► ◄Back►
────────────────────────────────────────────────────────────────────────────
MODM_UNPREPARE
 
        This message is sent to a MIDI output device to clean up the
        preparation performed by the MODM_PREPARE message.
 
Parameters
        DWORD dwParam1
            Specifies a far pointer to MIDIHDR structure identifying the
            data block.
 
        DWORD dwParam2
            Specifies the size of the MIDIHDR 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.
 
        MIDIERR_STILLPLAYING
            The specified data block is still in the output queue.
 
Comments
        Driver support for this message is optional. If a driver supports
        this message, then it must also support MODM_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 output, it should set the MHDR_PREPARED
        bit in the dwFlags field of the MIDIHDR 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.
 
See also
.ref 
        MODM_PREPARE
 
                                       -♦-