comando MCI_RESTORE

Articolo
06/13/2023

Il comando MCI_RESTORE copia una bitmap da un file al buffer frame. I dispositivi digital-video riconoscono questo comando. Questo comando esegue l'azione opposta del comando MCI_CAPTURE .

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_RESTORE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_DGV_RESTORE_PARMS) lpRestore
);

Parametri

wDeviceID: Identificatore del dispositivo MCI che deve ricevere il messaggio di comando.
Dwflags: MCI_NOTIFY, MCI_WAIT o MCI_TEST. Per informazioni su questi flag, vedere Il flag Wait, Notify e Test Flag.
lpRestore: Puntatore a una struttura MCI_DGV_RESTORE_PARMS .

Valore restituito

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

Commenti

L'implementazione può riconoscere un'ampia gamma di formati di immagine, ma viene sempre accettata una bitmap indipendente dal dispositivo Windows.

I flag aggiuntivi seguenti si applicano ai dispositivi digital-video:

MCI_DGV_RESTORE_FROM: Il membro lpstrFileName della struttura identificata da lpRestore contiene un indirizzo di un buffer contenente il nome del file di origine. Il nome del file è obbligatorio.
MCI_DGV_RESTORE_AT: Il membro rc della struttura identificata da lpRestore contiene un rettangolo valido. Il rettangolo specifica un'area del buffer del frame rispetto all'origine. La prima coppia di coordinate specifica l'angolo superiore sinistro del rettangolo; la seconda coppia specifica la larghezza e l'altezza. Se questo flag non è specificato, l'immagine viene copiata nell'angolo superiore sinistro del buffer del frame.

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