comando MCI_FREEZE

O comando MCI_FREEZE congela o movimento na exibição. Os dispositivos de vídeo digital, sobreposição de vídeo e VCR reconhecem esse comando.

Para enviar esse comando, chame a função mciSendCommand com os parâmetros a seguir.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_FREEZE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpFreeze
);

Parâmetros

wDeviceID: Identificador de dispositivo do dispositivo MCI que deve receber a mensagem de comando.
dwFlags: MCI_NOTIFY, MCI_WAIT ou, para dispositivos de vídeo digital e VCR, MCI_TEST. Para obter informações sobre esses sinalizadores, consulte Os Sinalizadores de Espera, Notificação e Teste.
lpFreeze: Ponteiro para uma estrutura MCI_GENERIC_PARMS . (Dispositivos com parâmetros adicionais podem substituir essa estrutura por uma estrutura específica do dispositivo.)

Retornará zero se tiver êxito ou um erro, caso contrário.

Os seguintes sinalizadores adicionais são usados pelo tipo de dispositivo digitalvideo :

MCI_DGV_FREEZE_AT: O membro rc da estrutura identificada por lpFreeze contém um retângulo válido. O retângulo especifica uma região dentro do buffer de quadros que terá o bit de máscara de bloqueio para cada pixel ativado. Os pixels especificados não serão atualizados até que o bit da máscara de bloqueio seja desativado. Se esse sinalizador não for especificado, o retângulo usará como padrão todo o buffer de quadros. Esse sinalizador só terá suporte se o comando MCI_GETDEVCAPS retornar TRUE para o sinalizador MCI_DGV_GETDEVCAPS_CAN_LOCK.
MCI_DGV_FREEZE_OUTSIDE: A área fora da região especificada para o sinalizador MCI_DGV_FREEZE_AT está congelada.

Para dispositivos de vídeo digital, o parâmetro lpFreeze aponta para uma estrutura MCI_DGV_FREEZE_PARMS .

Os seguintes sinalizadores adicionais são usados pelo tipo de dispositivo vcr :

MCI_VCR_FREEZE_FIELD: Congele apenas um membro do quadro atual.
MCI_VCR_FREEZE_FRAME: Congele os dois campos do quadro atual.
MCI_VCR_FREEZE_INPUT: Congele o quadro atual na tela (usado para gravação).
MCI_VCR_FREEZE_OUTPUT: Congele o quadro atual do VCR (usado com captura de quadro).

Para dispositivos VCR, o parâmetro lpFreeze aponta para uma estrutura MCI_GENERIC_PARMS .

O seguinte sinalizador adicional é usado pelo tipo de dispositivo de sobreposição :

MCI_OVLY_RECT: O membro rc da estrutura identificada por lpFreeze contém um retângulo válido. Se esse sinalizador não for especificado, o driver do dispositivo congelará todo o quadro.

Para dispositivos de sobreposição de vídeo, o parâmetro lpFreeze aponta para uma estrutura MCI_OVLY_RECT_PARMS .

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]
Cabeçalho	Mmsystem.h (incluir Windows.h)