Compartir a través de

Método IDDrawExclModeVideoCallback::OnUpdateOverlay (strmif.h)

  • Artículo

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El OnUpdateOverlay método informa a la aplicación cuando la superficie superpuesta del vídeo está a punto de ser visible, invisible, cambiar tamaño o cambiar posición, de modo que la aplicación pueda volver a dibujar su ventana correctamente.

Sintaxis

HRESULT OnUpdateOverlay(
  [in] BOOL       bBefore,
  [in] DWORD      dwFlags,
  [in] BOOL       bOldVisible,
  [in] const RECT *prcOldSrc,
  [in] const RECT *prcOldDest,
  [in] BOOL       bNewVisible,
  [in] const RECT *prcNewSrc,
  [in] const RECT *prcNewDest
);

Parámetros

[in] bBefore

Valor booleano que especifica si la llamada se realiza antes o después del cambio relacionado con la superposición. TRUE especifica antes, FALSE especifica después.

[in] dwFlags

Valor de la enumeración AM_OVERLAY_NOTIFY_FLAGS que especifica lo que está a punto de cambiar o lo que ha cambiado.

[in] bOldVisible

Valor booleano que especifica si la ventana antigua está visible. TRUE significa que la ventana antigua está visible.

[in] prcOldSrc

Puntero al rectángulo que representa la posición de origen antigua de la superficie de DirectDraw.

[in] prcOldDest

Puntero al rectángulo que representa la posición de destino anterior del rectángulo en la superficie superpuesta.

[in] bNewVisible

Boolean que especifica si la nueva ventana está visible. TRUE significa que la nueva ventana está visible.

[in] prcNewSrc

Puntero al rectángulo que representa la nueva posición de origen de la superficie de DirectDraw.

[in] prcNewDest

Puntero al rectángulo que representa la nueva posición de destino del rectángulo en la superficie superpuesta.

Valor devuelto

Devuelve un valor HRESULT . Estos son algunos de los valores posibles.

Código devuelto Descripción
S_OK
 Correcto.
E_INVALIDARG
 Parámetro no válido.

Comentarios

La aplicación debe llamar a este método una vez antes de que se produzca el cambio relacionado con la superposición y una vez que se realicen los cambios. En la llamada antes del cambio, el cambio de superposición no se produce hasta que la aplicación finaliza la ejecución de este método.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado strmif.h (incluya Dshow.h)
Library Strmiids.lib

Consulte también

Códigos de error y éxito

IdDrawExclModeVideoCallback (interfaz)