iGraphBuilder 接口 (strmif.h)
[与此页面关联的功能 DirectShow 是一项旧功能。 它已被 MediaPlayer、 IMFMediaEngine 和 媒体基金会中的音频/视频捕获取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获 ，而不是 DirectShow。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]
此接口提供使应用程序能够生成筛选器图的方法。 筛选器关系图管理器实现此接口。
IGraphBuilder 接口继承自 IFilterGraph 接口。 IFilterGraph 提供基本操作，例如向图形添加筛选器或连接两个引脚。 IGraphBuilder 添加了从部分信息构造图形的更多方法。 例如，根据文件名， IGraphBuilder：：RenderFile 方法生成用于文件播放的图形。 IGraphBuilder：：Render 方法通过将新筛选器连接到图钉来呈现输出引脚中的数据。
使用这些方法，应用程序不需要在图中指定每个筛选器和引脚连接。 相反，筛选器关系图管理器会选择在用户系统上注册的筛选器，将其添加到图中，然后连接它们。 有关详细信息，请参阅 智能连接。
继承
IGraphBuilder 接口继承自 IFilterGraph。 IGraphBuilder 还具有以下类型的成员：
方法
IGraphBuilder 接口包含以下方法。
| IGraphBuilder：：Abort Abort 方法请求 Filter Graph 管理器尽快停止其当前任务。 |
| IGraphBuilder：：AddSourceFilter AddSourceFilter 方法将指定文件的源筛选器添加到筛选器图。 |
| IGraphBuilder：：Connect Connect 方法连接两个引脚，如有必要，使用中间针。 |
| IGraphBuilder：：Render Render 方法生成一个筛选器图，用于呈现来自指定输出引脚的数据。 |
| IGraphBuilder：：RenderFile RenderFile 方法生成用于呈现指定文件的筛选器图。 (IGraphBuilder.RenderFile) |
| IGraphBuilder：：SetLogFile SetLogFile 方法为尝试执行操作时采取的日志记录操作设置文件。 |
| IGraphBuilder：：ShouldOperationContinue ShouldOperationContinue 方法查询当前操作是否应继续。 |
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | strmif.h (包括 Dshow.h) |