CBaseFilter.FindPin 方法

该方法 FindPin 检索具有指定标识符的引脚。 此方法实现 IBaseFilter::FindPin 方法。

语法

HRESULT FindPin(
   LPCWSTR Id,
   IPin    **ppPin
);

parameters

Id

指向标识引脚的常量、以 null 结尾的 Unicode 字符串的指针。

ppPin

接收指向引脚 IPin 接口的指针的变量的地址。

返回值

返回以下 HRESULT 值之一。

返回代码 说明
S_OK
成功。
E_POINTER
NULL 指针参数。
VFW_E_NOT_FOUND
找不到匹配的引脚。

注解

此方法调用 CBasePin::Name 方法,将每个引脚的名称与 Id 参数指定的字符串进行比较。

如果方法成功, IPin 接口具有未完成的引用计数。 请务必在完成后释放它。

要求

要求 Value
标头
Amfilter.h (包括 Streams.h)

Strmbase.lib (零售版) ;
Strmbasd.lib (调试生成)

另请参阅

CBaseFilter 类