IGraphBuilder 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.]
This interface provides methods that enable an application to build a filter graph. The Filter Graph Manager implements this interface.
The IGraphBuilder interface inherits from the IFilterGraph interface. IFilterGraph provides basic operations, such as adding a filter to the graph or connecting two pins. IGraphBuilder adds further methods that construct graphs from partial information. For example, the IGraphBuilder::RenderFile method builds a graph for file playback, given the name of the file. The IGraphBuilder::Render method renders data from an output pin by connecting new filters to the pin.
Using these methods, an application does not need to specify every filter and pin connection in the graph. Instead, the Filter Graph Manager selects filters that are registered on the user's system, adds them to the graph, and connects them. For more information, see Intelligent Connect.
Inheritance
The IGraphBuilder interface inherits from IFilterGraph. IGraphBuilder also has these types of members:
Methods
The IGraphBuilder interface has these methods.
| IGraphBuilder::Abort The Abort method requests the Filter Graph Manager to halt its current task as quickly as possible. |
| IGraphBuilder::AddSourceFilter The AddSourceFilter method adds a source filter for a specified file to the filter graph. |
| IGraphBuilder::Connect The Connect method connects the two pins, using intermediates if necessary. |
| IGraphBuilder::Render The Render method builds a filter graph that renders the data from a specified output pin. |
| IGraphBuilder::RenderFile The RenderFile method builds a filter graph that renders the specified file. (IGraphBuilder.RenderFile) |
| IGraphBuilder::SetLogFile The SetLogFile method sets the file for logging actions taken when attempting to perform an operation. |
| IGraphBuilder::ShouldOperationContinue The ShouldOperationContinue method queries whether the current operation should continue. |
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Target Platform | Windows |
| Header | strmif.h (include Dshow.h) |