Método IAMOverlayFX::SetOverlayFX (strmif.h)

[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