ICaptureGraphBuilder::SetFiltergraph-Methode (strmif.h)

[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 Die ICaptureGraphBuilder-Schnittstelle ist veraltet. Verwenden Sie stattdessen ICaptureGraphBuilder2 .

 

Teilt dem Graph-Generator-Objekt mit, welches Filterdiagramm verwendet werden soll.

Syntax

HRESULT SetFiltergraph(
  [in] IGraphBuilder *pfg
);

Parameter

[in] pfg

Zeiger auf eine IGraphBuilder-Schnittstelle , die das Filterdiagramm angibt, das für nachfolgende Aufrufe der IFilterGraph::AddFilter-Methode verwendet werden soll.

Rückgabewert

Gibt einen HRESULT-Wert zurück.

Hinweise

Der Graph-Generator erstellt automatisch ein Filterdiagramm, wenn Sie diese Methode nicht aufrufen. Wenn Sie diese Methode aufrufen, nachdem der Graph-Generator einen eigenen Filtergraphen erstellt hat, schlägt der Aufruf fehl.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	strmif.h (include Dshow.h)

Weitere Informationen

Fehler- und Erfolgscodes

ICaptureGraphBuilder-Schnittstelle