Comando capture

El comando capture copia el contenido del búfer de fotogramas y lo almacena en el archivo especificado. Los dispositivos de vídeo digital reconocen este comando.

Para enviar este comando, llame a la función mciSendString con el parámetro lpszCommand establecido de la siguiente manera.

_stprintf_s(
  lpszCommand, 
  TEXT("capture %s %s %s"), 
  lpszDeviceID, 
  lpszCapture, 
  lpszFlags
); 

Parámetros

lpszDeviceID

Identificador de un dispositivo MCI. Este identificador o alias se asigna cuando se abre el dispositivo.

lpszCapture

Una o varias de las marcas siguientes:

Value	Significado
as pathname	Especifica la ruta de acceso de destino y el nombre de archivo de la imagen capturada. Se requiere esta marca.
en rectángulo	Especifica la región rectangular dentro del búfer de fotogramas que el dispositivo recorta y guarda en el disco. Si se omite, la región recortada tiene como valor predeterminado el rectángulo especificado o predeterminado en un comando put "source" anterior para esta instancia de dispositivo.

lpszFlags

Puede ser "wait", "notify", "test" o una combinación de estos. Para obtener más información sobre estas marcas, vea Las marcas de espera, notificación y prueba.

Valor devuelto

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

Comentarios

Este comando puede producir un error si el dispositivo está reproduciendo vídeo de movimiento actualmente o ejecutando alguna otra operación de uso intensivo de recursos. Si el búfer de fotogramas se actualiza en tiempo real, la actualización se pausa momentáneamente para que se capture una imagen completa. Si el dispositivo pausa la actualización, puede haber un efecto visual o audible. Si no se han establecido el formato de archivo, el algoritmo de compresión y los niveles de calidad, se usan sus valores predeterminados.

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]

Consulte también

MCI

Cadenas de comandos de MCI

put