IRenderEngine：：ConnectFrontEnd 方法

  • 项目

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

注意

[已弃用。 此 API 可能会从 Windows 的未来版本中删除。]

 

方法ConnectFrontEnd从当前时间线生成筛选器图的前端。

语法

HRESULT ConnectFrontEnd();

参数

此方法没有任何参数。

返回值

返回 HRESULT 值。 可能的返回值包括：

返回代码 说明
S_OK
 成功。
S_WARN_OUTPUTRESET
 已删除图形的呈现部分。
E_INVALIDARG
 未为此呈现引擎设置时间线。
E_MUST_INIT_RENDERER
 呈现引擎初始化失败。
E_RENDER_ENGINE_IS_BROKEN
 操作失败，因为项目未成功呈现。
E_UNEXPECTED
 意外错误。
VFW_E_INVALIDMEDIATYPE
 媒体类型无效。

 

备注

此方法不会生成筛选器图的呈现部分。 应用程序必须将前端的输出引脚连接到所需的呈现筛选器：

如果使用基本呈现引擎，则前端的输出引脚将生成未压缩的数据。 如果使用智能呈现引擎，则输出引脚将生成压缩数据。

如果在生成筛选器图后更改时间线，则必须再次调用 ConnectFrontEnd 以重新生成前端。 方法会尽可能保留图形的呈现部分。 但是，如果添加或删除组或更改组的顺序， ConnectFrontEnd 则会删除呈现部分，应用程序必须重新生成它。 如果 方法删除呈现部分，则返回S_WARN_OUTPUTRESET。

注意

头文件 Qedit.h 与版本 7 之后的 Direct3D 标头不兼容。

 

注意

若要获取 Qedit.h，请下载适用于 Windows Vista 和 .NET Framework 3.0 的Microsoft Windows SDK更新。 Qedit.h 在 Windows 7 和 .NET Framework 3.5 Service Pack 1 的Microsoft Windows SDK中不可用。

 

要求

要求 值
标头
Qedit.h
库
Strmiids.lib

另请参阅

IRenderEngine 接口

错误和成功代码