Méthode IDistributorNotify ::NotifyGraphChange (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 in Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation au lieu de DirectShow, si 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.]

La NotifyGraphChange méthode est appelée lorsque l’ensemble des filtres dans le graphique de filtres change ou que les connexions d’épingles changent.

Syntaxe

HRESULT NotifyGraphChange();

Valeur de retour

Retourne une valeur HRESULT .

Remarques

Cette méthode est appelée chaque fois que la méthode IFilterGraph ::AddFilter, IFilterGraph ::RemoveFilter ou IFilterGraph ::ConnectDirect est appelée ou qu’une méthode est appelée pour que l’une de ces méthodes soit appelée (par exemple , IGraphBuilder ::RenderFile).

Veillez à appeler Release sur tous les filtres conservés qui ont été supprimés à ce stade. Pour des raisons de performances, les PID peuvent choisir de ne pas réanalyser les filtres tant que les PID n’ont pas réellement besoin des interfaces, car plusieurs notifications distinctes peuvent être envoyées. Toutefois, il est important de libérer immédiatement toutes les interfaces mises en cache.

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)
Bibliothèque	Strmiids.lib

Voir aussi

Codes d’erreur et de réussite

IDistributorNotify, interface