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.

Comments

The waveform audio device uses this command.

See Also

MCI_COPY, MCI_DELETE, MCI_PASTE