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]

Confira também

MCI

Cadeias de caracteres de comando MCI

capability

Descongelar