CBasePin.CompleteConnect 方法

[与此页面关联的功能 DirectShow 是旧版功能。 它已被 MediaPlayerIMFMediaEngineMedia Foundation 中的音频/视频捕获所取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能在 Media Foundation 中使用 MediaPlayerIMFMediaEngine音频/视频捕获 ,而不是 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 类