ICaptureGraphBuilder2 Interface (Compact 2013)

  • Article

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