Interface IOverlay (strmif.h)

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement au nouveau code d’utiliser MediaPlayer, IMFMediaEngine et La capture audio/vidéo dans Media Foundation au lieu de DirectShow, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

L’interface IOverlay fournit des informations afin qu’un filtre puisse écrire directement dans la mémoire vidéo tout en plaçant la vidéo à la bonne position de fenêtre. Il est implémenté sur la broche d’entrée du convertisseur vidéo et communique avec un filtre amont (généralement un décompresseur vidéo) en appelant les méthodes IOverlayNotify de ce filtre pour l’informer des modifications apportées à la fenêtre vidéo.

Cette interface n’a aucune relation avec la fonctionnalité de superposition DirectDraw®. Le convertisseur vidéo Microsoft dessine les données qu’il reçoit via l’interface IMemInputPin , à l’aide des superpositions DirectDraw lorsqu’elles sont disponibles. Cette interface, utilisée à la place d’IMemInputPin, est destinée à fournir une prise en charge des notifications pour tout filtre amont qui contourne les fonctionnalités de dessin du convertisseur, mais nécessite des notifications d’autres propriétés d’affichage.

Pour plus d’informations sur la façon dont les interfaces IOverlayNotify et IOverlayNotify fonctionnent ensemble, consultez la IOverlay page de référence IOverlayNotify.

Pour plus d’informations sur les notifications asynchrones des modifications apportées à la fenêtre de rendu, consultez l’interface IOverlayNotify2 .

Cette interface est implémentée sur le filtre du convertisseur vidéo Microsoft® DirectShow®. Il peut également être implémenté sur des filtres de convertisseur vidéo de remplacement si vous le souhaitez. Dans ce cas, implémentez cette interface afin que les filtres écrivant directement dans la mémoire tampon d’image ou essayant de positionner une superposition sachent où afficher leur vidéo. Pour implémenter cette interface, le convertisseur doit être prêt à utiliser des méthodes sur l’interface IOverlayNotify ou l’interface IOverlayNotify2 du filtre effectuant le dessin, avec des notifications de modifications de propriété vidéo.

Le convertisseur basé sur une fenêtre dans DirectShow prend en charge les interfaces IMemInputPin et IOverlay . Ces deux interfaces s’excluent mutuellement. Un filtre choisit d’utiliser le transport IOverlay en fournissant un type de média pendant la connexion qui a un sous-type de MEDIASUBTYPE_Overlay. Après la connexion, il pourra obtenir et utiliser correctement l’interface IOverlay . S’il se connecte à d’autres formats vidéo (par exemple, MEDIASUBTYPE_RGB8), la tentative d’appel via IOverlay renvoie VFW_E_NOT_OVERLAY_CONNECTION.

Utilisez les méthodes de cette fonction à partir d’un filtre amont qui doit contrôler les propriétés de superposition vidéo et qui a l’intention de gérer l’affichage des données vidéo proprement dites. Cela est généralement utilisé par les décodeurs vidéo matériels qui ont une autre connexion au matériel vidéo.

Héritage

L’interface IOverlay hérite de l’interface IUnknown. IOverlay a également les types de membres suivants :

Méthodes

L’interface IOverlay possède ces méthodes.

IOverlay ::Advise La méthode Advise configure un lien d’avis pour les événements de superposition spécifiés par le paramètre dwInterests.
IOverlay ::GetClipList La méthode GetClipList récupère la liste de découpage.
IOverlay ::GetColorKey La méthode GetColorKey récupère la clé de couleur actuelle utilisée pour la keying chroma.
IOverlay ::GetDefaultColorKey La méthode GetDefaultColorKey récupère la clé de couleur par défaut utilisée pour une superposition de touches chroma.
IOverlay ::GetPalette La méthode GetPalette récupère la palette système actuelle.
IOverlay ::GetVideoPosition La méthode GetVideoPosition récupère les rectangles de source et de destination vidéo actuels.
IOverlay ::GetWindowHandle La méthode GetWindowHandle récupère le handle de fenêtre actuel.
IOverlay ::SetColorKey La méthode SetColorKey modifie la clé de couleur.
IOverlay ::SetPalette La méthode SetPalette définit la palette.
IOverlay ::Unadvise La méthode Unadvise met fin au lien de conseil établi avec l’interface IOverlayNotify.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	strmif.h (include Dshow.h)