comando MCI_DELETE

Il comando MCI_DELETE rimuove i dati dal file. I dispositivi digital-video e waveform-audio riconoscono questo comando.

Per inviare questo comando, chiamare la funzione mciSendCommand con i parametri seguenti.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_DELETE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpDelete
);

Parametri

wDeviceID

Identificatore del dispositivo MCI che deve ricevere il messaggio di comando.

Dwflags

MCI_NOTIFY, MCI_WAIT o, per dispositivi video digitali, MCI_TEST. Per informazioni su questi flag, vedere Flag di attesa, notifica e test.

lpDelete

Puntatore a una struttura MCI_GENERIC_PARMS . I dispositivi con set di comandi estesi potrebbero sostituire questa struttura con una struttura specifica del dispositivo.

Valore restituito

Restituisce zero se l'operazione ha esito positivo o un errore in caso contrario.

Commenti

I flag seguenti si applicano al tipo di dispositivo digitalvideo :

MCI_DGV_DELETE_AT

Un rettangolo è incluso nel membro rc della struttura identificata da lpDelete. Il rettangolo specifica la parte di ogni frame da eliminare. Quando si usa questo flag, il frame viene mantenuto nell'area di lavoro e l'area specificata dal rettangolo diventa nera. Se il flag viene omesso, MCI_DELETE l'intero frame viene rimosso dall'area di lavoro per impostazione predefinita.

MCI_DGV_DELETE_AUDIO_STREAM

Un numero di flusso audio è incluso nel membro dwAudioStream della struttura identificata da lpDelete. Se usi questo flag e vuoi anche eliminare il video, devi usare anche il flag MCI_DGV_DELETE_VIDEO_STREAM. Se non viene specificato alcun flag, i dati di tutti i flussi audio e video vengono eliminati.

MCI_DGV_DELETE_VIDEO_STREAM

Un numero di flusso video è incluso nel membro dwVideoStream della struttura identificata da lpDelete. Se usi questo flag e vuoi anche eliminare l'audio, devi usare anche il flag di MCI_DGV_DELETE_AUDIO_STREAM. Se non viene specificato alcun flag, i dati di tutti i flussi audio e video vengono eliminati.

MCI_FROM

Una posizione iniziale è inclusa nel membro dwFrom della struttura identificata da lpDelete. Le unità assegnate ai valori di posizione vengono specificate con il flag MCI_SET_TIME_FORMAT del comando MCI_SET .

MCI_TO

Una posizione finale è inclusa nel membro dwTo della struttura identificata da lpDelete. Le unità assegnate ai valori di posizione vengono specificate con il flag MCI_SET_TIME_FORMAT di MCI_SET.

Per i dispositivi digital-video, il parametro lpDelete punta a una struttura MCI_DGV_DELETE_PARMS .

I flag seguenti si applicano al tipo di dispositivo waveaudio :

MCI_FROM

Una posizione iniziale è inclusa nel membro dwFrom della struttura identificata da lpDelete. Le unità assegnate ai valori di posizione vengono specificate con il flag MCI_SET_TIME_FORMAT di MCI_SET.

MCI_TO

Una posizione finale è inclusa nel membro dwTo della struttura identificata da lpDelete. Le unità assegnate ai valori di posizione vengono specificate con il flag MCI_SET_TIME_FORMAT di MCI_SET.

Per i dispositivi waveform-audio, il parametro lpDelete punta a una struttura MCI_WAVE_DELETE_PARMS .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Mmsystem.h (include Windows.h)

Vedi anche

MCI

Comandi MCI