Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

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.

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

In addition to the methods inherited from IUnknown, the ICaptureGraphBuilder2interface 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

Windows Embedded CE Windows Embedded CE 6.0 and later
Windows Mobile Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later
Note Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements
For more information, see Setting Up the Build Environment

See Also

Reference

Other Resources

CoCreateInstance