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_DELETE
 
        This MCI command message removes data from the MCI element.
        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_DELETE:
 
            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 lpDelete.
 
            MCI_WAIT
                Specifies that the delete operation should finish before
                MCI returns control to the application.
 
        LPMCI_GENERIC_PARMS lpCut
            Specifies a far pointer to an MCI_GENERIC_PARMS data
            structure. (Devices with extended command sets might replace
            this data structure with a device-specific data structure.)
 
        Wave Audio Extensions
 
        DWORD dwFlags
            The following extensions apply to wave audio devices:
 
            MCI_FROM
                Specifies that a beginning position is included in the
                dwFrom field of the data structure identified by
                lpDelete. The units assigned to the position values is
                specified with the MCI_SET_TIME_FORMAT flag of the
                MCI_SET command.
 
            MCI_TO
                Specifies that an ending position is included in the
                dwTo field of the data structure identified by lpDelete.
                The units assigned to the position values is specified
                with the MCI_SET_TIME_FORMAT flag of the MCI_SET
                command.
 
        LPMCI_WAVE_DELETE_PARMS lpDelete
            Specifies a far pointer to an MCI_WAVE_DELETE_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.
 
See also
        MCI_COPY, MCI_DELETE, MCI_PASTE
 
                                       -♦-