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 值。 可能的返回值包括：
| 返回代码 | 说明 |
|---|---|
|
成功。 |
|
已删除图形的呈现部分。 |
|
未为此呈现引擎设置时间线。 |
|
呈现引擎初始化失败。 |
|
操作失败，因为项目未成功呈现。 |
|
意外错误。 |
|
媒体类型无效。 |
备注
此方法不会生成筛选器图的呈现部分。 应用程序必须将前端的输出引脚连接到所需的呈现筛选器：
- 若要预览，请调用 IRenderEngine：：RenderOutputPins 方法。
- 若要输出文件，请调用 IRenderEngine：：GetGroupOutputPin 检索每个组的输出引脚，然后将引脚连接到多路复用器筛选器。
如果使用基本呈现引擎，则前端的输出引脚将生成未压缩的数据。 如果使用智能呈现引擎，则输出引脚将生成压缩数据。
如果在生成筛选器图后更改时间线，则必须再次调用 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中不可用。
要求
| 要求 | 值 |
|---|---|
| 标头 |
|
| 库 |
|
另请参阅