ICaptureGraphBuilder2 Interface

Send Feedback

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
ControlStream Sets the start and stop times for one or more streams of captured data.
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.

Requirements

DirectShow applications and DirectShow filters have different include file and link library requirements.

For more information, see Setting Up the Build Environment.

Pocket PC: Windows Mobile 5.0 and later
Smartphone: Windows Mobile 5.0 and later
OS Versions: Windows CE 5.01 and later
Header:

See Also

DirectShow Interfaces | CoCreateInstance

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.