Interface IFilterChain (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 IFilterChain fournit des méthodes pour démarrer, arrêter ou supprimer des chaînes de filtres dans un graphique de filtres. Le gestionnaire de graphe de filtres expose cette interface.

Une chaîne de filtres est une séquence de filtres, chacun avec au plus une broche d’entrée connectée et une broche de sortie connectée, qui forme une ligne de filtres ininterrompue. Une chaîne de filtre est définie par le filtre au début de la chaîne et le filtre à la fin de la chaîne. (Il peut s’agir du même filtre, ce qui fait une chaîne d’un filtre.) Par définition, il existe un chemin de flux unique allant du début de la chaîne en aval à la fin de la chaîne.

Les méthodes de cette interface sont utiles dans les situations où un flux de données entier peut apparaître ou disparaître, comme une application de vidéoconférence qui reçoit plusieurs flux sur un réseau. Pour plus d’informations, consultez Génération de graphiques dynamiques. Pour contrôler des flux individuels sur un filtre de capture, utilisez plutôt l’interface IAMStreamControl .

Héritage

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

Méthodes

L’interface IFilterChain a ces méthodes.

IFilterChain::P auseChain La méthode PauseChain bascule tous les filtres d’une chaîne de filtres dans un état suspendu.
IFilterChain::RemoveChain La méthode RemoveChain supprime chaque filtre d’une chaîne de filtres du graphique de filtre.
IFilterChain::StartChain La méthode StartChain bascule tous les filtres d’une chaîne de filtres dans un état d’exécution.
IFilterChain::StopChain La méthode StopChain bascule tous les filtres d’une chaîne de filtres dans un état arrêté.

Configuration requise

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