通过

ICaptureGraphBuilder：：FindInterface 方法 (strmif.h)

  • 项目

[与此页面关联的功能 DirectShow 是旧版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获所取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能在 Media Foundation 中使用 MediaPlayer、 IMFMediaEngine 和 音频/视频捕获 ，而不是 DirectShow。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

注意ICaptureGraphBuilder 接口已弃用。 请改用 ICaptureGraphBuilder2 。
 
在筛选器上查找指定接口，从筛选器上游和下游，也可以仅在给定类别的输出引脚上查找。

语法

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

参数

[in] pCategory

指向指定输出引脚类别的 GUID 的指针。 有关所有固定类别的列表，请参阅 固定属性集 。 NULL 表示搜索所有输出引脚，而不考虑类别。

[in] pf

指向筛选器的 IBaseFilter 接口的指针。

[in] riid

所需接口的引用 ID。

[out] ppint

void 指针的地址。 如果找到接口，此方法将初始化 ppint ，使其包含指向找到的接口的指针的地址。 使用完 接口后，调用 Release 方法以递减引用计数。

返回值

返回 HRESULT 值。

注解

除非提供了类别，否则此方法在筛选器上查找接口，并上游和筛选器的下游。 如果提供了类别，则它仅位于该类别的输出引脚的下游。 它可用于在呈现器、多路复用器、电视调谐器、横杠等上查找接口。

如果 pCategory 等于 &LOOK_UPSTREAM_ONLY，则图形生成器将查看参数 pf 中给定的筛选器的上游，但不在筛选器本身上，也不会在筛选器的下游查看。

如果 pCategory 等于 &LOOK_DOWNSTREAM_ONLY，则图形生成器将查找参数 pf 中给定的筛选器的下游，但不会在筛选器本身上查找，也不会查看筛选器上游。

要求

要求 值
目标平台 Windows
标头 strmif.h (包括 Dshow.h)

另请参阅

错误和成功代码

ICaptureGraphBuilder 接口