ICaptureGraphBuilder::FindInterface-Methode (strmif.h)

Artikel
01/10/2024

[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.]

Hinweis Die ICaptureGraphBuilder-Schnittstelle ist veraltet. Verwenden Sie stattdessen ICaptureGraphBuilder2 .

Sucht nach der angegebenen Schnittstelle für den Filter, Upstream und nach dem Filter und optional nur am Ausgabestift der angegebenen Kategorie.

Syntax

HRESULT FindInterface(
  [in]  const GUID  *pCategory,
  [in]  IBaseFilter *pf,
  [in]  REFIID      riid,
  [out] void        **ppint
);

Parameter

[in] pCategory

Zeiger auf eine GUID, die die Ausgabeheftkategorie angibt. Eine Liste aller Anheftungskategorien finden Sie unter Anheftungseigenschaftensatz . NULL gibt an, dass alle Ausgabepins unabhängig von der Kategorie durchsucht werden.

[in] pf

Zeiger auf die IBaseFilter-Schnittstelle des Filters.

[in] riid

Referenz-ID der gewünschten Schnittstelle.

[out] ppint

Adresse eines Voidzeigers. Wenn die Schnittstelle gefunden wurde, initialisiert diese Methode ppint , sodass sie die Adresse eines Zeigers auf die gefundene Schnittstelle enthält. Rufen Sie die Release-Methode auf, um die Verweisanzahl zu verringern, wenn Sie mit der Schnittstelle fertig sind.

Rückgabewert

Gibt einen HRESULT-Wert zurück.

Hinweise

Diese Methode sucht nach der Schnittstelle für den Filter und Upstream und nach dem Filter, sofern keine Kategorie angegeben ist. Wenn eine Kategorie angegeben wird, wird sie nur nach dem Ausgabepin dieser Kategorie angezeigt. Es kann verwendet werden, um Schnittstellen für Renderer, Multiplexer, TV-Tuner, Kreuzleisten usw. zu finden.

Wenn pCategory &LOOK_UPSTREAM_ONLY entspricht, sucht der Graph-Generator Upstream des im Parameter pf angegebenen Filters, aber nicht auf dem Filter selbst oder nach dem Filter.

Wenn pCategory &LOOK_DOWNSTREAM_ONLY entspricht, sieht der Graphen-Generator nach dem filter aus, der im Parameter pf angegeben ist, aber nicht auf den Filter selbst oder Upstream des Filters.

Anforderungen

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

Weitere Informationen

Fehler- und Erfolgscodes

ICaptureGraphBuilder-Schnittstelle

Freigeben über