ICaptureGraphBuilder2::FindPin 方法 (strmif.h)

[与此页面关联的功能 DirectShow 是一项旧功能。 它已被 MediaPlayerIMFMediaEngine媒体基金会中的音频/视频捕获取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayerIMFMediaEngineMedia Foundation 中的音频/视频捕获 ,而不是 DirectShow。 如果可能,Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

方法 FindPin 检索筛选器上的特定引脚,或确定给定的引脚是否与指定的条件匹配。

语法

HRESULT FindPin(
  [in]  IUnknown      *pSource,
  [in]  PIN_DIRECTION pindir,
  [in]  const GUID    *pCategory,
  [in]  const GUID    *pType,
  [in]  BOOL          fUnconnected,
  [in]  int           num,
  [out] IPin          **ppPin
);

参数

[in] pSource

指向筛选器上的接口的指针,或指向引脚上的接口的指针。

[in] pindir

PIN_DIRECTION 枚举的成员,该枚举指定输入或输出) (引脚方向。

[in] pCategory

指向 GUID 的指针,该 GUID 指定 Pin 属性集中列出的固定类别之一。 若要匹配任何固定,而不考虑类别,请将此参数设置为 NULL

[in] pType

指向指定媒体类型的主要类型 GUID 的指针。 使用 NULL 匹配任何媒体类型。

[in] fUnconnected

指定引脚是否必须未连接的布尔值。 如果 为 TRUE,则引脚必须未连接。 如果 为 FALSE,则引脚可以连接或未连接。

[in] num

要从匹配的引脚集中检索的引脚的从零开始的索引。 如果 pSource 是指向筛选器的指针,并且多个图钉与搜索条件匹配,则此参数指定要检索的图钉。 如果 pSource 是指向引脚的指针,则忽略此参数。

[out] ppPin

用于接收匹配引脚的 IPin 接口的指针的地址。

返回值

如果找到匹配的引脚,则返回S_OK,否则返回E_FAIL。

备注

如果 pSource 是指向筛选器的指针,则该方法将搜索该筛选器上与搜索条件匹配的第 n个引脚,其中 nnum 参数提供。 如果方法找到匹配的图钉,它将返回指向 ppPin 参数中的图钉的指针。

如果 pSource 是指向固定的指针,该方法会根据搜索条件测试该固定。 如果引脚与条件匹配,该方法将返回S_OK,并在 ppPin 参数中返回指向引脚的 IPin 接口的指针。 否则,它将返回E_FAIL。

在任一情况下,如果方法成功,则 ppPin 参数中返回的 IPin 接口具有未完成的引用计数。 使用完接口后,请务必释放它。

通常,应用程序不需要使用此方法。 当 ICaptureGraphBuilder2::RenderStream 方法无法生成筛选器图时,它适用于异常复杂的任务。 使用此方法从捕获筛选器检索所需的引脚,然后手动生成图形的其余部分。

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 strmif.h (包括 Dshow.h)
Library Strmiids.lib

另请参阅

错误和成功代码

ICaptureGraphBuilder2 接口