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

A filter graph that performs video or audio capture is called a capture graph. Capture graphs are often more complicated than file playback graphs. To make it easier for applications to build capture graphs, DirectShow provides a helper object called the Capture Graph Builder. The Capture Graph Builder exposes the ICaptureGraphBuilder2 interface, which contains methods for building and controlling a capture graph.

Start by calling CoCreateInstanceto create new instances of the Capture Graph Builder and the Filter Graph Manager. Then initialize the Capture Graph Builder by calling ICaptureGraphBuilder2::SetFiltergraphwith a pointer to the Filter Graph Manager's IGraphBuilder Interface.

The following code shows a helper function to perform these steps.

Copy Code
HRESULT InitCaptureGraphBuilder(
  IGraphBuilder **ppGraph, 	 // Receives the pointer.
  ICaptureGraphBuilder2 **ppBuild  // Receives the pointer.
)
{
	if (!ppGraph || !ppBuild) {
		return E_POINTER;
}
	IGraphBuilder *pGraph = NULL;
	ICaptureGraphBuilder2 *pBuild = NULL;

	// Create the Capture Graph Builder.
	HRESULT hr = CoCreateInstance(CLSID_CaptureGraphBuilder, NULL, 
		CLSCTX_INPROC_SERVER, IID_IcaptureGraphBuilder2,
(void**)&pBuild);
	if (SUCCEEDED(hr)) {
		// Create the Filter Graph Manager.
		hr = CoCreateInstance(CLSID_FilterGraph, 0,
CLSCTX_INPROC_SERVER,
			IID_IGraphBuilder, (void**)&pGraph);
		if (SUCCEEDED(hr)) {
			// Initialize the Capture Graph Builder.
			pBuild->SetFiltergraph(pGraph);

			// Return both interface pointers to the caller.
			*ppBuild = pBuild;
			*ppGraph = pGraph; // The caller must release both
interfaces.
			return S_OK;
	}
		else {
			pBuild->Release();
	}
}
	return hr; // Failed
}

Throughout this section on video capture, it is assumed that you are using the Capture Graph Builder to create the capture graph. However, it is possible to build capture graphs entirely by using IGraphBuildermethods. This is considered an advanced topic, however, and the Capture Graph Builder methods are preferred. For more information, see Advanced Capture Topics.

See Also

Concepts

Video Capture