Interfaz IOverlayNotify (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.

La IOverlayNotify interfaz proporciona un filtro ascendente, como un descodificador, con notificaciones de cambios en la ventana de representación. Esto incluye notificaciones de cambios en la paleta, la clave de color y la posición de la ventana, y cambios en la región visible (recorte).

La mayoría de los descodificadores de vídeo de software permiten que el representador de vídeo dibuje las imágenes descomprimidas que producen pasando los ejemplos multimedia a la interfaz IMemInputPin en el pin de entrada del representador.

Sin embargo, algunos filtros de descodificación de vídeo (normalmente placas de descompresión de hardware) controlan el dibujo de las propias imágenes, quizás mediante un conector VGA. Estos filtros no necesitan usar IMemInputPin, sino que, en su lugar, pueden usar la interfaz IOverlay proporcionada por el pin de entrada del representador. A través de esta interfaz, se puede notificar al descodificador cuando cambia la posición o el tamaño de la ventana, o cuando cambia la paleta del sistema actual para instalar y cambiar las teclas de color y las paletas.

Los descodificadores que hacen su propio dibujo deben implementar las IOverlayNotify interfaces e IOverlayNotify2 . El representador usa esta interfaz para notificar al descodificador cada vez que cambia el tamaño o la posición de la ventana, se cambia la paleta del sistema o se usa una clave de color diferente. El descodificador debe llamar al método IOverlay::Advise en el pin de entrada del representador, para configurar la devolución de llamada. Una vez establecida la devolución de llamada, el representador llama a los métodos del IOverlayNotify descodificador cuando se producen los eventos adecuados. Para cancelar la devolución de llamada, use el método IOverlay::Unadvise .

El representador de vídeo es el único filtro que llama a los métodos de esta interfaz. Esto se realiza automáticamente mediante el representador de vídeo predeterminado. Si está escribiendo un representador de vídeo de reemplazo, deberá usar los métodos de esta interfaz si el filtro admite IOverlay y esta interfaz se pasa al filtro en una llamada IOverlay::Advise .

Herencia

La interfaz IOverlayNotify hereda de la interfaz IUnknown . IOverlayNotify también tiene estos tipos de miembros:

Métodos

La interfaz IOverlayNotify tiene estos métodos.

IOverlayNotify::OnClipChange El método OnClipChange proporciona una notificación de que la región visible de la ventana ha cambiado. Es esencial que cualquier hardware de superposición se actualice para reflejar el cambio en la región visible antes de volver de este método.
IOverlayNotify::OnColorKeyChange El método OnColorKeyChange proporciona una notificación de que la clave de color de la ventana ha cambiado.
IOverlayNotify::OnPaletteChange El método OnPaletteChange proporciona una notificación de que la paleta de la ventana ha cambiado.
IOverlayNotify::OnPositionChange El método OnPositionChange proporciona una notificación de que la posición ha cambiado.

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)