DIrectShow Interface--ICaptureGraphBuilder2

http://msdn.microsoft.com/en-us/library/aa924828.aspx

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

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

---

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