comando MCI_SAVE
Il comando MCI_SAVE salva il file corrente. I dispositivi che modificano i file non devono eliminare la copia originale finché non ricevono il messaggio di salvataggio. I dispositivi video sovrapposti e waveform-audio riconoscono questo comando. Anche se i dispositivi digitali e i sequencer MIDI riconoscono anche questo comando, i driver MCIAVI e MCISEQ non lo implementano.
Per inviare questo comando, chiamare la funzione mciSendCommand con i parametri seguenti.
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_SAVE,
DWORD dwFlags,
(DWORD) (LPMCI_SAVE_PARMS ) lpSave
);
Parametri
-
wDeviceID
-
Identificatore del dispositivo MCI che deve ricevere il messaggio di comando.
-
Dwflags
-
MCI_NOTIFY, MCI_WAIT o, per i dispositivi digital-video e VCR, MCI_TEST. Per informazioni su questi flag, vedere Il flag Wait, Notify e Test Flag.
-
lpSave
-
Puntatore a una struttura MCI_SAVE_PARMS . I dispositivi con parametri aggiuntivi potrebbero sostituire questa struttura con una struttura specifica del dispositivo.
Valore restituito
Restituisce zero se ha esito positivo o un errore in caso contrario.
Commenti
Questo comando è supportato dai dispositivi che restituiscono TRUE quando si chiama il comando MCI_GETDEVCAPS con il flag di MCI_GETDEVCAPS_CAN_SAVE .
Il flag aggiuntivo seguente si applica a tutti i dispositivi che supportano MCI_SAVE:
-
MCI_SAVE_FILE
-
Il membro lpfilename della struttura identificata da lpSave contiene un indirizzo di un buffer contenente il nome file di destinazione.
I flag aggiuntivi seguenti vengono usati con il tipo di dispositivo digitalvideo :
-
MCI_DGV_RECT
-
Il membro rc della struttura identificata da lpSave contiene un rettangolo valido. Il rettangolo specifica un'area del buffer frame che verrà salvata nel file specificato. La prima coppia di coordinate specifica l'angolo superiore sinistro del rettangolo; la seconda coppia specifica la larghezza e l'altezza. I dispositivi video digitali devono usare il comando MCI_CAPTURE per acquisire il contenuto del buffer di fotogrammi. I dispositivi di sovrapposizione video devono anche usare MCI_CAPTURE. Questo flag è compatibile con il set di comandi MCI video-overlay esistente.
-
MCI_DGV_SAVE_ABORT
-
Arresta un'operazione di salvataggio in corso. Questo deve essere l'unico flag presente.
-
MCI_DGV_SAVE_KEEPRESERVE
-
Lo spazio su disco inutilizzato lasciato dal comando originale MCI_RESERVE non viene deallocato.
Per i dispositivi digital-video, il parametro lpSave punta a una struttura MCI_DGV_SAVE_PARMS .
Il flag aggiuntivo seguente viene usato con il tipo di dispositivo di sovrapposizione :
-
MCI_OVLY_RECT
-
Il membro rc della struttura identificata da lpSave contiene un rettangolo di visualizzazione valido che indica l'area del buffer video da salvare.
Per i dispositivi di sovrapposizione video, il parametro lpSave punta a una struttura MCI_OVLY_SAVE_PARMS .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows 2000 Professional [solo app desktop] |
| Server minimo supportato |
Windows 2000 Server [solo app desktop] |
| Intestazione |
|