ICaptureGraphBuilder2：：FindPin 方法 (strmif.h)
[与此页面关联的功能 DirectShow 是一项旧功能。 它已被 MediaPlayer、 IMFMediaEngine 和 媒体基金会中的音频/视频捕获取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer、 IMFMediaEngine 和 Media 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个引脚，其中 n 由 num 参数提供。 如果方法找到匹配的图钉，它将返回指向 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 |