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.
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 |