comando freeze

El comando freeze inmoviliza la entrada de vídeo o la salida de vídeo en un VCR o deshabilita la adquisición de vídeo en el búfer de fotogramas. Los dispositivos de vídeo digital, superposición de vídeo y VCR 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("freeze %s %s %s"), 
  lpszDeviceID, 
  lpszFreezeFlags, 
  lpszFlags
); 

Parámetros

lpszDeviceID

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

lpszFreezeFlags

Marca que identifica lo que se va a inmovilizar. En la tabla siguiente se enumeran los tipos de dispositivo que reconocen el comando freeze y las marcas usadas por cada tipo.

Valor	Significado	Significado
digitalvideo	en rectángulo	Fuera
overlay	en rectángulo
Vcr	campo frame	input output

En la tabla siguiente se enumeran las marcas que se pueden especificar en el parámetro lpszFreezeFlags y sus significados.

Valor	Significado
en rectángulo	Especifica la región que se inmovilizará. En el caso de los dispositivos de superposición de vídeo, esta región tendrá deshabilitada la adquisición de vídeo. En el caso de los dispositivos de vídeo digital, los píxeles del rectángulo tendrán activado su bit de máscara de bloqueo (a menos que se especifique la marca "fuera"). El rectángulo es relativo al origen del búfer de vídeo y se especifica como X1 Y1 X2 Y2. Las coordenadas X1 Y1 especifican la esquina superior izquierda del rectángulo y las coordenadas X2 Y2 especifican el ancho y el alto.
campo	Inmoviliza el primer campo. El campo se asume de forma predeterminada (si no se especifica ningún marco ni campo).
frame	Inmoviliza todo el marco, mostrando ambos campos.
input	Inmoviliza el marco actual de la imagen de entrada, tanto si está en pausa como en ejecución.
output	Inmoviliza el marco actual de la salida del VCR. Si el VCR se está reproduciendo cuando se emite la inmovilización, el fotograma actual se inmoviliza y se pausa el VCR. Si el VCR se pausa cuando se emite este comando, el marco actual se inmoviliza. La imagen inmovilizada permanece en el dispositivo de salida hasta que se emite un comando de descongelado . Si no se especifican "input" ni "output", se asume "output".
Fuera	Indica que el área fuera de la región especificada con la marca "at" está inmovilizada.

lpszFlags

Puede ser "wait", "notify" o ambos. En el caso de los dispositivos de vídeo digital y VCR, también se puede especificar "prueba". 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

Cuando se usa con dispositivos VCR, este comando está pensado para tarjetas de captura de fotogramas.

Para especificar regiones de adquisición irregulares con la marca "at", use una serie de comandos de inmovilización y descongelación . Algunos dispositivos de superposición de vídeo limitan la complejidad de la región de adquisición.

Este comando solo se admite si una llamada al comando de funcionalidad con la marca "puede inmovilizar" devuelve TRUE.

Ejemplos

El siguiente comando deshabilita la adquisición de vídeo en un cuadrado de 100 píxeles en la esquina superior izquierda del búfer de vídeo.

freeze vboard at 0 0 100 100

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

capability

Descongelar