CTransInPlaceFilter.CompleteConnect 方法

  • 项目

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

方法 CompleteConnect 完成引脚连接。

语法

HRESULT CompleteConnect(
   PIN_DIRECTION direction,
   IPin          *pReceivePin
);

参数

direction

PIN_DIRECTION枚举类型的成员，指定筛选器上的哪个引脚正在建立连接。

pReceivePin

指向此连接尝试中另一个引脚的 IPin 接口的指针。

返回值

返回 HRESULT。 可能的值包括下表中显示的值。

返回代码 说明
S_OK
 成功。
VFW_E_NOT_IN_GRAPH
 筛选器不在筛选器图中。

备注

此方法替代 CTransformFilter：：CompleteConnect 方法。

筛选器的行为取决于引脚连接的顺序：

  • 如果首先连接输入引脚，则连接将使用临时分配器。 连接输出引脚后，筛选器将重新连接输入引脚。 重新连接输入引脚会导致上游筛选器重新协商分配器。 此时，输入引脚从下游筛选器建议分配器。 有关详细信息，请参阅 CTransInPlaceInputPin：：GetAllocator。
  • 如果首先连接输出引脚，则输出引脚不会选择分配器。 连接输入引脚后，它将协商两个连接的分配器。 如果输入和输出媒体类型不同，筛选器将使用输入类型重新连接输出引脚。

筛选器通过调用 CBaseFilter：：ReconnectPin 方法执行所有引脚重新连接。 而 ReconnectPin 方法又调用筛选器关系图管理器上的 IFilterGraph2：：ReconnectEx 方法。

要求

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

另请参阅

CTransInPlaceFilter 类