CBasePin.CompleteConnect 方法

  • 项目

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

方法 CompleteConnect 完成与另一个引脚的连接。

语法

virtual HRESULT CompleteConnect(
   IPin *pReceivePin
);

参数

pReceivePin

指向另一个引脚的 IPin 接口的指针。

返回值

返回 S_OK。

注解

在连接过程结束时，在两个引脚上调用此方法。 连接引脚从 CBasePin：：Connect 方法中调用它，接收引脚从 CBasePin：：ReceiveConnection 方法中调用它。

在基类中，此方法仅返回S_OK。 如果派生类对完成连接有任何要求，则它应重写此方法。 例如， CBaseOutputPin 类使用此方法确定内存分配器。

如果此方法失败，则整个连接尝试也会失败，并且引脚与接收引脚断开连接。

要求

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

另请参阅

CBasePin 类