IRenderEngine::GetFilterGraph-Methode

Hinweis

[Veraltet. Diese API kann aus zukünftigen Releases von Windows entfernt werden.]

Die GetFilterGraph -Methode ruft ggf. das Filterdiagramm ab, das von der Render-Engine erstellt wurde.

Syntax

HRESULT GetFilterGraph(
  [out] IGraphBuilder **ppFG
);

Parameter

ppFG [ out]

Empfängt einen Zeiger auf die IGraphBuilder-Schnittstelle des Filterdiagramms. Er empfängt den Wert NULL, wenn kein Filterdiagramm vorhanden ist.

Rückgabewert

Gibt einen der folgenden HRESULT-Werte zurück:

Rückgabecode Beschreibung
S _ OK
Erfolg.
E _ MUSS _ RENDERER INIT _
Fehler beim Initialisieren der Render-Engine.
E _ POINTER
Ungültiger Zeiger.

Bemerkungen

Verwenden Sie die IRenderEngine::ConnectFrontEnd-Methode, um das Front-End des Filterdiagramms zu erstellen. Verwenden Sie für die Vorschau die IRenderEngine::RenderOutputPins, um das Diagramm zu vervollständigen. Verbinden Sie das Front-End für die Dateiausgabe mit einer Kombination aus Mux-/Dateiwriter. Weitere Informationen finden Sie unter Rendern eines Project.

Das resultierende Diagramm kann ausgeführt, angehalten, beendet und gesucht werden. Die Wiedergaberate kann jedoch nicht geändert werden.

Wenn der Wert von * ppFG bei der Rückgabe ungleich NULL ist, weist die IGraphBuilder-Schnittstelle einen ausstehenden Verweiszähler auf. Stellen Sie sicher, dass Sie die Schnittstelle freigeben, wenn Sie sie nicht mehr verwenden.

Hinweis

Die Headerdatei Qedit.h ist mit Direct3D-Headern nach Version 7 nicht kompatibel.

Hinweis

Laden Sie zum Abrufen von Qedit.h das Microsoft Windows SDK-Update für Windows Vista und .NET Framework 3.0herunter. Qedit.h ist im Microsoft Windows SDK für Windows 7 und .NET Framework 3.5 Service Pack 1 nicht verfügbar.

Requirements (Anforderungen)

Anforderung Wert
Header
Qedit.h
Bibliothek
Strmiids.lib

Weitere Informationen

IRenderEngine-Schnittstelle

Fehler- und Erfolgscodes