Comando freeze
O comando freeze congela a entrada de vídeo ou a saída de vídeo em um VCR ou desabilita a aquisição de vídeo para o buffer de quadros. Os dispositivos de vídeo digital, sobreposição de vídeo e VCR reconhecem esse comando.
Para enviar esse comando, chame a função mciSendString com o parâmetro lpszCommand definido da seguinte maneira.
_stprintf_s(
lpszCommand,
TEXT("freeze %s %s %s"),
lpszDeviceID,
lpszFreezeFlags,
lpszFlags
);
Parâmetros
-
lpszDeviceID
-
Identificador de um dispositivo MCI. Esse identificador ou alias é atribuído quando o dispositivo é aberto.
-
lpszFreezeFlags
-
Sinalizador que identifica o que congelar. A tabela a seguir lista os tipos de dispositivo que reconhecem o comando freeze e os sinalizadores usados por cada tipo.
Valor Significado Significado digitalvideo no retângulo Fora overlay no retângulo Videocassete - field
- frame
- input
- output
A tabela a seguir lista os sinalizadores que podem ser especificados no parâmetro lpszFreezeFlags e seus significados.
Valor Significado no retângulo Especifica a região que será congelada. Para dispositivos de sobreposição de vídeo, essa região terá a aquisição de vídeo desabilitada. Para dispositivos de vídeo digital, os pixels dentro do retângulo terão seu bit de máscara de bloqueio ativado (a menos que o sinalizador "externo" seja especificado). O retângulo é relativo à origem do buffer de vídeo e é especificado como X1 Y1 X2 Y2. As coordenadas X1 Y1 especificam o canto superior esquerdo do retângulo e as coordenadas X2 Y2 especificam a largura e a altura. field Congela o primeiro campo. O campo é assumido por padrão (se nenhum quadro nem campo for especificado). frame Congela todo o quadro, exibindo ambos os campos. input Congela o quadro atual da imagem de entrada, seja ela pausada ou em execução. output Congela o quadro atual da saída do VCR. Se o VCR estiver sendo reproduzido quando o congelamento for emitido, o quadro atual será congelado e o VCR será pausado. Se o VCR estiver em pausa quando esse comando for emitido, o quadro atual será congelado. A imagem congelada permanece no dispositivo de saída até que um comando de descongelamento seja emitido. Se nem "input" nem "output" for especificado, "output" será assumido. Fora Indica que a área fora da região especificada usando o sinalizador "at" está congelada. -
lpszFlags
-
Pode ser "wait", "notify" ou ambos. Para dispositivos de vídeo digital e VCR, "teste" também pode ser especificado. Para obter mais informações sobre esses sinalizadores, consulte Os Sinalizadores de Espera, Notificação e Teste.
Valor Retornado
Retornará zero se tiver êxito ou um erro, caso contrário.
Comentários
Quando usado com dispositivos VCR, esse comando destina-se a cartões que capturam quadros.
Para especificar regiões de aquisição irregulares com o sinalizador "at", use uma série de comandos de congelamento e descongelamento . Alguns dispositivos de sobreposição de vídeo limitam a complexidade da região de aquisição.
Esse comando só terá suporte se uma chamada para o comando capability com o sinalizador "pode congelar" retornar TRUE.
Exemplos
O comando a seguir desabilita a aquisição de vídeo em um quadrado de 100 pixels no canto superior esquerdo do buffer de vídeo.
freeze vboard at 0 0 100 100
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows 2000 Server [somente aplicativos da área de trabalho] |