comando MCI_RESTORE

El comando MCI_RESTORE copia un mapa de bits de un archivo en el búfer de fotogramas. Los dispositivos de vídeo digital reconocen este comando. Este comando realiza la acción opuesta del comando MCI_CAPTURE .

Para enviar este comando, llame a la función mciSendCommand con los parámetros siguientes.

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

Parámetros

wDeviceID

Identificador de dispositivo del dispositivo MCI que va a recibir el mensaje de comando.

dwFlags

MCI_NOTIFY, MCI_WAIT o MCI_TEST. Para obtener información sobre estas marcas, vea Las marcas Wait, Notify y Test.

lpRestore

Puntero a una estructura de MCI_DGV_RESTORE_PARMS .

Valor devuelto

Devuelve cero si es correcto o si se produce un error en caso contrario.

Comentarios

La implementación puede reconocer una variedad de formatos de imagen, pero siempre se acepta un mapa de bits independiente del dispositivo Windows (DIB).

Las siguientes marcas adicionales se aplican a los dispositivos de vídeo digital:

MCI_DGV_RESTORE_FROM

El miembro lpstrFileName de la estructura identificada por lpRestore contiene una dirección de un búfer que contiene el nombre de archivo de origen. Se requiere el nombre de archivo.

MCI_DGV_RESTORE_AT

El miembro rc de la estructura identificada por lpRestore contiene un rectángulo válido. El rectángulo especifica una región del búfer de fotogramas con respecto a su origen. El primer par de coordenadas especifica la esquina superior izquierda del rectángulo; el segundo par especifica el ancho y el alto. Si no se especifica esta marca, la imagen se copia en la esquina superior izquierda del búfer de fotogramas.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	Mmsystem.h (incluya Windows.h)

Consulte también

MCI

Comandos MCI