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] |