Condividi tramite


comando MCI_RESTORE

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