IGraphBuilder-Schnittstelle (strmif.h)

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Diese Schnittstelle stellt Methoden bereit, mit denen eine Anwendung ein Filterdiagramm erstellen kann. Der Filter Graph-Manager implementiert diese Schnittstelle.

Die IGraphBuilder-Schnittstelle erbt von der IFilterGraph-Schnittstelle . IFilterGraph bietet grundlegende Vorgänge, z. B. das Hinzufügen eines Filters zum Diagramm oder das Verbinden von zwei Pins. IGraphBuilder fügt weitere Methoden hinzu, die Graphen aus partiellen Informationen erstellen. Beispielsweise erstellt die IGraphBuilder::RenderFile-Methode unter Angabe des Dateinamens ein Diagramm für die Dateiwiedergabe. Die IGraphBuilder::Render-Methode rendert Daten von einem Ausgabenadel, indem neue Filter mit dem Pin verbunden werden.

Bei Verwendung dieser Methoden muss eine Anwendung nicht jede Filter- und Pinverbindung im Diagramm angeben. Stattdessen wählt der Filtergraph-Manager Filter aus, die im System des Benutzers registriert sind, fügt sie dem Diagramm hinzu und verbindet sie. Weitere Informationen finden Sie unter Intelligent Connect.

Vererbung

Die IGraphBuilder-Schnittstelle erbt von IFilterGraph. IGraphBuilder verfügt auch über folgende Membertypen:

Methoden

Die IGraphBuilder-Schnittstelle verfügt über diese Methoden.

IGraphBuilder::Abort Die Abort-Methode fordert den Filter Graph-Manager auf, seine aktuelle Aufgabe so schnell wie möglich anzuhalten.
IGraphBuilder::AddSourceFilter Die AddSourceFilter-Methode fügt dem Filterdiagramm einen Quellfilter für eine angegebene Datei hinzu.
IGraphBuilder::Connect Die Connect-Methode verbindet die beiden Pins und verwendet bei Bedarf Zwischenverbindungen.
IGraphBuilder::Render Die Render-Methode erstellt ein Filterdiagramm, das die Daten von einem angegebenen Ausgabenadel rendert.
IGraphBuilder::RenderFile Die RenderFile-Methode erstellt ein Filterdiagramm, das die angegebene Datei rendert. (IGraphBuilder.RenderFile)
IGraphBuilder::SetLogFile Die SetLogFile-Methode legt die Datei für protokollierungsaktionen fest, die beim Ausführen eines Vorgangs ausgeführt werden.
IGraphBuilder::ShouldOperationContinue Die ShouldOperationContinue-Methode fragt ab, ob der aktuelle Vorgang fortgesetzt werden soll.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	strmif.h (include Dshow.h)

Weitere Informationen

IFilterGraph

Schnittstellen