| Microsoft DirectX 8.1 (C++) |
The ICaptureGraphBuilder2 interface provides methods for building capture graphs, and other custom filter graphs. The Capture Graph Builder object implements this interface.
This interface replaces the ICaptureGraphBuilder interface. It works with Microsoft® Windows® Driver Model (WDM) capture drivers that can capture more than one media type, such as both audio and video. The original ICaptureGraphBuilder interface does not work with devices that use the same driver for both video and audio capture.
Note The ICaptureGraphBuilder2 interface does not use the Video Mixing Renderer (VMR) or Video Port Manager. To build a capture graph with either or both of these filters (available only on Windows XP Home Edition and Windows XP Professional), you can still use the ICaptureGraphBuilder2 interface to build the graph, but you will need to remove the Video Renderer manually and replace it with the VMR.
In addition to the methods inherited from IUnknown, the ICaptureGraphBuilder2 interface exposes the following methods.
| Method | Description |
| AllocCapFile | Preallocates a capture file to a specified size. |
| ControlStream | Sets the start and stop times for one or more streams of captured data. |
| CopyCaptureFile | Copies the valid media data from a capture file. |
| FindInterface | Searches the graph for a specified interface, starting from a specified filter. |
| FindPin | Retrieves a particular pin on a filter, or determines whether a given pin matches the specified criteria. |
| GetFiltergraph | Retrieves the filter graph that the builder is using. |
| RenderStream | Connects an output pin on a source filter to a rendering filter, optionally through a compression filter. |
| SetFiltergraph | Specifies a filter graph for the capture graph builder to use. |
| SetOutputFileName | Creates the file writing section of the filter graph. |
See Also