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	Mmsystem.h (include Windows.h)

Vedi anche

MCI

Comandi MCI