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

Cette interface fournit des méthodes qui permettent à une application de générer un graphique de filtre. Le Gestionnaire de graphe de filtre implémente cette interface.

L’interface IGraphBuilder hérite de l’interface IFilterGraph. IFilterGraph fournit des opérations de base, telles que l’ajout d’un filtre au graphe ou la connexion de deux broches. IGraphBuilder ajoute d’autres méthodes qui construisent des graphiques à partir d’informations partielles. Par exemple, la méthode IGraphBuilder ::RenderFile génère un graphique pour la lecture de fichiers, en fonction du nom du fichier. La méthode IGraphBuilder ::Render restitue les données à partir d’une broche de sortie en connectant de nouveaux filtres à la broche.

À l’aide de ces méthodes, une application n’a pas besoin de spécifier chaque connexion de filtre et d’épingle dans le graphique. Au lieu de cela, le Gestionnaire de graphe de filtre sélectionne les filtres inscrits sur le système de l’utilisateur, les ajoute au graphique et les connecte. Pour plus d’informations, consultez Intelligent Connect.

Héritage

L’interface IGraphBuilder hérite d’IFilterGraph. IGraphBuilder a également les types de membres suivants :

Méthodes

L’interface IGraphBuilder a ces méthodes.

IGraphBuilder ::Abort La méthode Abort demande au Gestionnaire de graphe de filtre d’arrêter sa tâche actuelle aussi rapidement que possible.
IGraphBuilder ::AddSourceFilter La méthode AddSourceFilter ajoute un filtre source pour un fichier spécifié au graphique de filtre.
IGraphBuilder ::Connect La méthode Connect connecte les deux broches, en utilisant des intermédiaires si nécessaire.
IGraphBuilder ::Render La méthode Render génère un graphique de filtre qui restitue les données à partir d’une broche de sortie spécifiée.
IGraphBuilder ::RenderFile La méthode RenderFile génère un graphique de filtre qui restitue le fichier spécifié. (IGraphBuilder.RenderFile)
IGraphBuilder ::SetLogFile La méthode SetLogFile définit le fichier pour la journalisation des actions effectuées lors de la tentative d’exécution d’une opération.
IGraphBuilder ::ShouldOperationContinue La méthode ShouldOperationContinue demande si l’opération en cours doit continuer.

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

IFilterGraph

Interfaces