ICaptureGraphBuilder2 Interface (Compact 2013)

3/26/2014

This interface provides methods for building capture graphs, and other custom filter graphs. The Capture Graph Builder object implements this interface.

The Capture Graph Builder is a helper object for building video and audio capture graphs. Capture and editing applications can use this component to construct filter graphs. The following code shows how to create this object using CoCreateInstance.

CoCreateInstance( CLSID_CaptureGraphBuilder,
                  NULL,
                  CLSCTX_INPROC_SERVER,
                  IID_ICaptureGraphBuilder2,
                  (void**) &pCaptureGraphBuilder)

In addition to the methods inherited from IUnknown, the ICaptureGraphBuilder2 interface exposes the methods shown in the following table.

Method	Description
ICaptureGraphBuilder2::ControlStream	Sets the start and stop times for one or more streams of captured data.
ICaptureGraphBuilder2::FindInterface	Searches the graph for a specified interface, starting from a specified filter.
ICaptureGraphBuilder2::FindPin	Retrieves a particular pin on a filter, or determines whether a given pin matches the specified criteria.
ICaptureGraphBuilder2::GetFiltergraph	Retrieves the filter graph that the builder is using.
ICaptureGraphBuilder2::RenderStream	Connects an output pin on a source filter to a rendering filter, optionally through a compression filter.
ICaptureGraphBuilder2::SetFiltergraph	Specifies a filter graph for the capture graph builder to use.
ICaptureGraphBuilder2::SetOutputFileName	Creates the file writing section of the filter graph.

Requirements

Header	dshow.h
Library	Strmiids.lib

See Also

Reference

DirectShow Interfaces

Other Resources

CoCreateInstance