Interface IOverlayNotify (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 IOverlayNotify fournit un filtre amont, tel qu’un décodeur, avec des notifications des modifications apportées à la fenêtre de rendu. Cela inclut les notifications des modifications apportées à la palette, à la touche de couleur et à la position de la fenêtre, ainsi que les modifications de région visibles (découpage).

La plupart des décodeurs vidéo logiciels permettent au convertisseur vidéo de dessiner les images décompressées qu’ils produisent en transmettant les exemples multimédias à l’interface IMemInputPin sur la broche d’entrée du convertisseur.

Toutefois, certains filtres de décodage vidéo (généralement des cartes de décompression matérielles) gèrent le dessin des images eux-mêmes, peut-être à l’aide d’un connecteur VGA. Ces filtres n’ont pas besoin d’utiliser IMemInputPin, mais peuvent utiliser l’interface IOverlay fournie par la broche d’entrée du convertisseur. Grâce à cette interface, le décodeur peut être averti lorsque la position ou la taille de la fenêtre change, ou lorsque la palette système actuelle change afin d’installer et de modifier les touches de couleur et les palettes.

Les décodeurs qui effectuent leur propre dessin doivent implémenter les IOverlayNotify interfaces et IOverlayNotify2 . Le convertisseur utilise cette interface pour notifier le décodeur chaque fois que la taille ou la position de la fenêtre change, que la palette système change ou qu’une autre clé de couleur est utilisée. Le décodeur doit appeler la méthode IOverlay ::Advise sur la broche d’entrée du convertisseur pour configurer le rappel. Une fois le rappel établi, le convertisseur appelle les méthodes du IOverlayNotify décodeur lorsque les événements appropriés se produisent. Pour annuler le rappel, utilisez la méthode IOverlay ::Unadvise .

Le convertisseur vidéo est le seul filtre qui appelle les méthodes sur cette interface. Cette opération est effectuée automatiquement par le convertisseur vidéo par défaut. Si vous écrivez un convertisseur vidéo de remplacement, vous devez utiliser les méthodes de cette interface si votre filtre prend en charge IOverlay et que cette interface est passée à votre filtre dans un appel IOverlay ::Advise .

Héritage

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

Méthodes

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

IOverlayNotify ::OnClipChange La méthode OnClipChange indique que la région visible de la fenêtre a changé. Il est essentiel que tout matériel de superposition soit mis à jour pour refléter la modification apportée à la région visible avant de retourner à partir de cette méthode.
IOverlayNotify ::OnColorKeyChange La méthode OnColorKeyChange indique que la clé de couleur de la fenêtre a changé.
IOverlayNotify ::OnPaletteChange La méthode OnPaletteChange indique que la palette de la fenêtre a changé.
IOverlayNotify ::OnPositionChange La méthode OnPositionChange indique que la position a changé.

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)