CBaseFilter.ReconnectPin 方法

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

方法 ReconnectPin 中断现有引脚连接,并使用指定的媒体类型将其重新连接到同一引脚。

语法

HRESULT ReconnectPin(
   IPin                *pPin,
   AM_MEDIA_TYPE const *pmt
);

参数

pPin

指向引脚的 IPin 接口的指针。

Pmt

指向指定媒体类型的 AM_MEDIA_TYPE 结构的指针,或 NULL

返回值

返回 HRESULT 值。 可能的值包括下表中列出的值。

返回代码 说明
S_OK
成功。
E_NOINTERFACE
m_pGraph 成员变量为 NULL

备注

此方法在筛选器图管理器上调用 IFilterGraph2::ReconnectEx 方法。 如果 IFilterGraph2 接口不可用,该方法将调用 IFilterGraph::Reconnect

要求

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

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

另请参阅

CBaseFilter 类