comando MCI_FREEZE

El comando MCI_FREEZE bloquea el movimiento en la pantalla. 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 mciSendCommand con los parámetros siguientes.

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

Parámetros

wDeviceID: Identificador de dispositivo del dispositivo MCI que va a recibir el mensaje de comando.
dwFlags: MCI_NOTIFY, MCI_WAIT o, para dispositivos de vídeo digital y VCR, MCI_TEST. Para obtener información sobre estas marcas, vea Las marcas Wait, Notify y Test.
lpFreeze: Puntero a una estructura de MCI_GENERIC_PARMS . (Los dispositivos con parámetros adicionales pueden reemplazar esta estructura por una estructura específica del dispositivo).

Devuelve cero si es correcto o si se produce un error en caso contrario.

El tipo de dispositivo digitalvideo usa las siguientes marcas adicionales:

MCI_DGV_FREEZE_AT: El miembro rc de la estructura identificada por lpFreeze contiene un rectángulo válido. El rectángulo especifica una región dentro del búfer de fotogramas que tendrá el bit de máscara de bloqueo para cada píxel activado. Los píxeles especificados no se actualizarán hasta que se desactive su bit de máscara de bloqueo. Si no se especifica esta marca, el rectángulo tiene como valor predeterminado todo el búfer de fotogramas. Esta marca solo se admite si el comando MCI_GETDEVCAPS devuelve TRUE para la marca de MCI_DGV_GETDEVCAPS_CAN_LOCK.
MCI_DGV_FREEZE_OUTSIDE: El área fuera de la región especificada para la marca MCI_DGV_FREEZE_AT está inmovilizada.

En el caso de los dispositivos de vídeo digital, el parámetro lpFreeze apunta a una estructura de MCI_DGV_FREEZE_PARMS .

El tipo de dispositivo vcr usa las siguientes marcas adicionales:

MCI_VCR_FREEZE_FIELD: Inmovilizar solo un miembro del marco actual.
MCI_VCR_FREEZE_FRAME: Inmovilizar ambos campos del marco actual.
MCI_VCR_FREEZE_INPUT: Inmovilizar el marco actual en la pantalla (se usa para la grabación).
MCI_VCR_FREEZE_OUTPUT: Inmovilizar el marco actual desde el VCR (usado con la captura de fotogramas).

En el caso de los dispositivos VCR, el parámetro lpFreeze apunta a una estructura de MCI_GENERIC_PARMS .

El tipo de dispositivo de superposición usa la siguiente marca adicional:

MCI_OVLY_RECT: El miembro rc de la estructura identificada por lpFreeze contiene un rectángulo válido. Si no se especifica esta marca, el controlador del dispositivo inmovilizará todo el marco.

En el caso de los dispositivos de superposición de vídeo, el parámetro lpFreeze apunta a una estructura de MCI_OVLY_RECT_PARMS .

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	Mmsystem.h (incluya Windows.h)