CPullPin.Active 方法

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

Active 方法创建一个工作线程,用于从输出引脚拉取数据。 此方法还提交分配器。

语法

HRESULT Active();

参数

此方法没有任何参数。

返回值

返回 HRESULT 值。 可能的值包括以下值。

返回代码 说明
S_OK
成功。
E_UNEXPECTED
未正确建立引脚连接。
E_FAIL
无法创建线程,或者线程已存在。

备注

当拥有的筛选器变为活动状态时调用此方法。 (如果输入引脚派生自 CBasePin,请重写 CBasePin::Active 方法.)

在调用此方法之前,请调用 CPullPin::Connect 方法以与输出引脚建立连接。

要求

要求
标头
Pullpin.h

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

另请参阅

CPullPin 类