CTransformFilter.GetPin 方法

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

方法 GetPin 检索图钉。

语法

virtual CBasePin* GetPin(
   int n
);

参数

n

指定引脚的编号,从零开始编制索引。 在此筛选器中,引脚 0 是输入引脚,引脚 1 是输出引脚。

返回值

返回指向实现固定的 CBasePin 对象的指针;如果方法失败,则返回 NULL

备注

此方法实现纯虚拟 CBaseFilter::GetPin 方法。 首次调用 方法时,它会创建两个引脚。

此方法不会递增返回的引脚上的引用计数,因此返回的引脚没有未完成的引用计数。 如果调用方需要在引脚上保留引用,则应在引脚上调用 IUnknown::AddRef 方法。

如果筛选器使用默认 的 CTransformInputPinCTransformOutputPin 引脚,则可能不需要重写此方法。 但是,如果筛选器使用扩展这些类的引脚,则必须重写此方法以创建该类型的引脚。

要求

要求
标头
Transfrm.h (包括 Streams.h)

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

另请参阅

CTransformFilter 类