CTransInPlaceFilter.GetPin 方法

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

方法 GetPin 检索图钉。

语法

virtual CBasePin* GetPin(
   int n
);

参数

n

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

返回值

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

备注

此方法替代 CTransformFilter::GetPin 方法。 首次调用 方法时,它会创建两个引脚。

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

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

要求

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

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

另请参阅

CTransInPlaceFilter 类