Compartir a través de

Método IAMOverlayFX::SetOverlayFX (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 SetOverlayFX método aplica los efectos especificados a la superficie superpuesta.

Sintaxis

HRESULT SetOverlayFX(
  [in] DWORD dwOverlayFX
);

Parámetros

[in] dwOverlayFX

Valor que especifica los efectos que se van a aplicar. El valor debe ser una combinación lógica de marcas de la enumeración AMOVERLAYFX o el método devuelve E_INVALIDARG.

Valor devuelto

Devuelve un valor HRESULT que depende de la implementación de la interfaz. La implementación de DirectShow puede devolver uno de los siguientes valores u otros no enumerados.

Código devuelto Descripción
E_FAIL
 Error.
E_INVALIDARG
 Argumento no válido.
S_OK
 Correcto.

Comentarios

La aplicación debe llamar a este método mientras se ejecuta el grafo de filtro. Los efectos se aplican inmediatamente.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [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

Interfaz IAMOverlayFX