Interface IDistributorNotify (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.]

L’interface IDistributorNotify permet à un serveur de distribution de plug-in d’être averti lorsque le graphique de filtre change.

Les applications n’utilisent jamais cette interface. Implémentez cette interface si vous écrivez un serveur de distribution de plug-ins (PID) et que vous souhaitez que le PID reçoive des notifications de contrôle et des modifications dans la composition des graphiques de filtres.

Le Gestionnaire de graphe de filtre interroge cette interface sur tous les distributeurs de plug-ins qu’il agrège. Si un PID expose cette interface, le Gestionnaire de graphes de filtre informe le PID de toute modification d’état en appelant les méthodes IDistributorNotify avant d’appeler les méthodes IBaseFilter équivalentes sur les filtres. Le Gestionnaire de graphe de filtre appelle également la méthode IDistributorNotify ::NotifyGraphChange chaque fois qu’il ajoute ou supprime un filtre, ou que des connexions d’épingle sont modifiées.

Lors d’un appel à une méthode IDistributorNotify , ne conservez aucune section critique susceptible d’être détenue par un autre chemin de code qui appelle des méthodes dans le Gestionnaire de graphe de filtres. Cela pourrait entraîner un blocage.

Héritage

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

Méthodes

L’interface IDistributorNotify a ces méthodes.

IDistributorNotify ::NotifyGraphChange La méthode NotifyGraphChange est appelée lorsque l’ensemble de filtres dans le graphique de filtres change ou que les connexions d’épingles changent.
IDistributorNotify ::P ause La méthode Pause est appelée lorsque le graphe de filtre entre dans un état suspendu.
IDistributorNotify ::Run La méthode Run est appelée lorsque le graphe de filtres entre dans un état d’exécution.
IDistributorNotify ::SetSyncSource La méthode SetSyncSource est appelée lorsqu’une nouvelle horloge est inscrite.
IDistributorNotify ::Stop La méthode Stop est appelée lorsque le graphique de filtre entre dans un état arrêté.

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)

Voir aussi

Distributeurs de plug-ins