Interfaz IOverlay (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 IOverlay interfaz proporciona información para que un filtro pueda escribir directamente en la memoria de vídeo mientras coloca el vídeo en la posición correcta de la ventana. Se implementa en el pin de entrada del representador de vídeo y se comunica con un filtro ascendente (normalmente un descomprimor de vídeo) llamando a los métodos IOverlayNotify del filtro para notificarle los cambios en la ventana de vídeo.

Esta interfaz no tiene ninguna relación con la funcionalidad de superposición de DirectDraw®. El representador de vídeo de Microsoft dibuja los datos que recibe a través de la interfaz IMemInputPin , mediante superposiciones de DirectDraw cuando está disponible. Esta interfaz, que se usa en lugar de IMemInputPin, está pensada para proporcionar compatibilidad con notificaciones para cualquier filtro ascendente que omita las funcionalidades de dibujo del representador, pero necesita notificaciones de otras propiedades de presentación.

Consulte la página de referencia de IOverlayNotify para obtener más información sobre cómo funcionan juntas las IOverlay interfaces iOverlayNotify .

Consulte la interfaz IOverlayNotify2 para obtener más información sobre las notificaciones asincrónicas de los cambios en la ventana de representación.

Esta interfaz se implementa en el filtro de representador de vídeo Microsoft® DirectShow®. También se puede implementar en filtros de representador de vídeo de reemplazo si lo desea. Si lo hace, implemente esta interfaz para que filtre la escritura directamente en el búfer de fotogramas o intente colocar una superposición saber dónde mostrar su vídeo. Para implementar esta interfaz, el representador debe estar preparado para usar métodos en la interfaz IOverlayNotify o en la interfaz IOverlayNotify2 del filtro que realiza el dibujo, con notificaciones de cambios de propiedad de vídeo.

El representador basado en ventanas de DirectShow admite interfaces IMemInputPin e IOverlay . Estas dos interfaces son mutuamente excluyentes. Un filtro elige usar el transporte IOverlay proporcionando un tipo de medio durante la conexión que tiene un subtipo de MEDIASUBTYPE_Overlay. Después de la conexión, podrá obtener y usar correctamente la IOverlay interfaz . Si se conecta con cualquier otro formato de vídeo (como MEDIASUBTYPE_RGB8), al intentar llamar a través IOverlay de devuelve VFW_E_NOT_OVERLAY_CONNECTION.

Use los métodos de esta función desde un filtro ascendente que debe controlar las propiedades de superposición de vídeo y pretende controlar la visualización de los propios datos de vídeo. Normalmente, los descodificadores de vídeo de hardware que tienen una conexión alternativa al hardware de vídeo.

Herencia

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

Métodos

La interfaz IOverlay tiene estos métodos.

IOverlay::Advise El método Advise configura un vínculo de aviso para los eventos de superposición especificados por el parámetro dwInterests.
IOverlay::GetClipList El método GetClipList recupera la lista de recortes.
IOverlay::GetColorKey El método GetColorKey recupera la clave de color actual que se usa para la tecla cromática.
IOverlay::GetDefaultColorKey El método GetDefaultColorKey recupera la clave de color predeterminada usada para una superposición de clave cromática.
IOverlay::GetPalette El método GetPalette recupera la paleta del sistema actual.
IOverlay::GetVideoPosition El método GetVideoPosition recupera los rectángulos de origen y destino de vídeo actuales.
IOverlay::GetWindowHandle El método GetWindowHandle recupera el identificador de ventana actual.
IOverlay::SetColorKey El método SetColorKey cambia la clave de color.
IOverlay::SetPalette El método SetPalette establece la paleta.
IOverlay::Unadvise El método Unadvise finaliza el vínculo de aviso establecido con la interfaz IOverlayNotify.

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 (incluye Dshow.h)