CTransformFilter.GetPin 方法

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

方法 GetPin 检索图钉。

语法

virtual CBasePin* GetPin(
   int n
);

参数

n

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

返回值

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

备注

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

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

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

要求

要求	值
标头	Transfrm.h (包括 Streams.h)
库	Strmbase.lib (零售版本) ; Strmbasd.lib (调试生成)

另请参阅

CTransformFilter 类