IRenderEngine::GetFilterGraph-Methode
[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]
Hinweis
[Veraltet. Diese API kann aus zukünftigen Versionen von Windows entfernt werden.]
Die GetFilterGraph -Methode ruft ggf. das Filterdiagramm ab, das die Render-Engine erstellt hat.
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 |
|---|---|
|
Erfolg. |
|
Fehler beim Initialisieren des Rendermoduls. |
|
Der Zeiger ist ungültig. |
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 abzuschließen. Verbinden Sie für die Dateiausgabe das Front-End mit einer Mux-/Dateischreiber-Kombination. Weitere Informationen finden Sie unter Rendern eines Projekts.
Das resultierende Diagramm kann ausgeführt, angehalten, angehalten 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 eine ausstehende Verweisanzahl auf. Stellen Sie sicher, dass Sie die Schnittstelle freigeben, wenn Sie die Verwendung abgeschlossen haben.
Hinweis
Die Headerdatei Qedit.h ist nicht mit Direct3D-Headern ab Version 7 kompatibel.
Hinweis
Um Qedit.h zu erhalten, laden Sie das Microsoft Windows SDK Update für Windows Vista und .NET Framework 3.0 herunter. Qedit.h ist im Microsoft Windows SDK für Windows 7 und .NET Framework 3.5 Service Pack 1 nicht verfügbar.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|
| Bibliothek |
|
Siehe auch