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►
────────────────────────────────────────────────────────────────────────────
MCI_STOP
 
        This MCI command message stops all play and record sequences,
        unloads all play buffers, and ceases display of video images.
        Support of this message by a device is optional. The parameters
        and flags for this message vary according to the selected
        device.
 
Parameters
        DWORD dwFlags
            The following flags apply to all devices supporting
            MCI_STOP:
 
            MCI_NOTIFY
                Specifies that MCI should post the MM_MCINOTIFY message
                when this command completes. The window to receive this
                message is specified in the dwCallback field of the data
                structure identified by lpStop.
 
            MCI_WAIT
                Specifies that the device should stop before MCI returns
                control to the application.
 
        LPMCI_GENERIC_PARMS lpStop
            Specifies a far pointer to the MCI_GENERIC_PARMS data
            structure. (Devices with extended command sets might replace
            this data structure with a device-specific data structure.)
 
Return value
        Returns zero if successful. Otherwise, it returns an MCI error
        code.
 
Comments
        The difference between MCI_STOP and MCI_PAUSE depends upon the
        device. If possible, MCI_PAUSE suspends device operation but
        leaves the device ready to resume play immediately.
 
See also
        MCI_PAUSE, MCI_PLAY, MCI_RECORD, MCI_RESUME
 
                                       -♦-