IRenderEngine::SetFilterGraph-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.]

Die SetFilterGraph -Methode gibt ein Filterdiagramm für die zu verwendende Render-Engine an.

Syntax

HRESULT SetFilterGraph(
   IGraphBuilder *pFG
);

Parameter

Pfg

Zeiger auf die IGraphBuilder-Schnittstelle des Filterdiagramms.

Rückgabewert

Gibt einen der folgenden HRESULT-Werte zurück:

Bemerkungen

Die meisten Anwendungen müssen diese Methode nicht aufrufen. Es ist typischer, dass die Render-Engine den Graphen für Sie erstellen lässt, indem sie die IRenderEngine::ConnectFrontEnd-Methode aufruft .

Diese Methode schlägt fehl, wenn die Render-Engine bereits über ein Filterdiagramm verfügt.

Rufen Sie niemals einen Zeiger auf einen Filtergraph ab, der von einer Render-Engine erstellt wurde, und verwenden Sie ihn dann als Parameter für diese Methode in einer anderen Render-Engine. Dies führt zu unvorhersehbaren Ergebnissen.

Die ConnectFrontEnd-Methode löscht alle vorhandenen Filtergraphen, behält jedoch den instance des Filtergraph-Managers bei.

Anforderungen

Siehe auch

IRenderEngine-Schnittstelle

Fehler- und Erfolgscodes