Compartilhar via


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.)

Valor Retornado

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

Comentários

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 .

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

Confira também

MCI

Comandos MCI