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)

另请参阅

IFilterGraph

接口