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 |
|