ICaptureGraphBuilder interface (strmif.h)

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

Note  This interface has been deprecated. It will continue to be supported for backward compatibility with existing applications, but new applications should use the ICaptureGraphBuilder2 interface.

 

The ICaptureGraphBuilder interface enables you to build capture graphs, preview graphs, file recompression graphs, or other custom graphs.

Inheritance

The ICaptureGraphBuilder interface inherits from the IUnknown interface. ICaptureGraphBuilder also has these types of members:

Methods

The ICaptureGraphBuilder interface has these methods.

ICaptureGraphBuilder::AllocCapFile Note  The ICaptureGraphBuilder interface is deprecated. Use ICaptureGraphBuilder2 instead. Preallocates a capture file to a specified size.
ICaptureGraphBuilder::ControlStream Note  The ICaptureGraphBuilder interface is deprecated. Use ICaptureGraphBuilder2 instead. Sends stream control messages to the pin of the specified category on one or more capture filters in a graph.
ICaptureGraphBuilder::CopyCaptureFile Note  The ICaptureGraphBuilder interface is deprecated. Use ICaptureGraphBuilder2 instead. Copies the valid media data from the preallocated capture file.
ICaptureGraphBuilder::FindInterface Note  The ICaptureGraphBuilder interface is deprecated. Use ICaptureGraphBuilder2 instead. Looks for the specified interface on the filter, upstream and downstream from the filter, and, optionally, only on the output pin of the given category.
ICaptureGraphBuilder::GetFiltergraph Note  The ICaptureGraphBuilder interface is deprecated. Use ICaptureGraphBuilder2 instead. Retrieves the filter graph that the builder is using.
ICaptureGraphBuilder::RenderStream Note  The ICaptureGraphBuilder interface is deprecated. Use ICaptureGraphBuilder2 instead. Connects a source filter's pin, of an optionally specified category, to the rendering filter, and optionally through another filter.
ICaptureGraphBuilder::SetFiltergraph Note  The ICaptureGraphBuilder interface is deprecated. Use ICaptureGraphBuilder2 instead. Tells the graph builder object which filter graph to use.
ICaptureGraphBuilder::SetOutputFileName Note  The ICaptureGraphBuilder interface is deprecated. Use ICaptureGraphBuilder2 instead. Creates the rendering section of the filter graph, which will save bits to disk with the specified file name.

Requirements

Requirement	Value
Target Platform	Windows
Header	strmif.h

See also

Deprecated Interfaces