iCaptureGraphBuilder2 接口 (strmif.h)
[与此页面关联的功能 DirectShow 是一项旧功能。 它已被 MediaPlayer、 IMFMediaEngine 和 媒体基金会中的音频/视频捕获取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获 ，而不是 DirectShow。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]
接口 ICaptureGraphBuilder2 生成捕获图和其他自定义筛选器图。 Capture Graph Builder 对象实现此接口。
注意 默认情况下，接口
ICaptureGraphBuilder2 不使用视频混合呈现器 (VMR) 、增强的视频呈现器 (EVR) 或 视频端口管理器 筛选器。继承
ICaptureGraphBuilder2 接口继承自 IUnknown 接口。 ICaptureGraphBuilder2 还具有以下类型的成员：
方法
ICaptureGraphBuilder2 接口包含以下方法。
| ICaptureGraphBuilder2：：AllocCapFile AllocCapFile 方法将捕获文件预分配为指定大小。 为获得最佳结果，请始终捕获到大于捕获数据大小的已碎片整理、预先分配的捕获文件。 |
| ICaptureGraphBuilder2：：ControlStream ControlStream 方法为一个或多个捕获的数据流设置开始和停止时间。 |
| ICaptureGraphBuilder2：：CopyCaptureFile CopyCaptureFile 方法从捕获文件复制有效的媒体数据。 |
| ICaptureGraphBuilder2：：FindInterface FindInterface 方法从指定的筛选器开始，在图形中搜索指定的接口。 |
| ICaptureGraphBuilder2：：FindPin FindPin 方法检索筛选器上的特定引脚，或确定给定的引脚是否与指定的条件匹配。 |
| ICaptureGraphBuilder2：：GetFiltergraph GetFiltergraph 方法检索捕获图生成器正在使用的筛选器图。 |
| ICaptureGraphBuilder2：：RenderStream RenderStream 方法可以选择通过中间筛选器将源筛选器上的输出引脚连接到接收器筛选器。 |
| ICaptureGraphBuilder2：：SetFiltergraph SetFiltergraph 方法指定捕获图生成器要使用的筛选器图。 |
| ICaptureGraphBuilder2：：SetOutputFileName SetOutputFileName 方法创建筛选器图的文件写入部分。 |
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | strmif.h (包括 Dshow.h) |