IGraphBuilder Interface

Microsoft DirectShow 9.0

IGraphBuilder Interface

This interface provides methods that enable an application to build a filter graph. The Filter Graph Manager implements this interface.

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

In addition to the methods inherited from IFilterGraph, the IGraphBuilder interface exposes the following methods.

Method	Description
Connect	Connects two pins. If they will not connect directly, this method connects them with intervening transforms.
Render	Adds a chain of filters to a specified output pin to render it.
RenderFile	Builds a filter graph that renders the specified file.
AddSourceFilter	Adds a source filter to the filter graph for a specific file.
SetLogFile	Sets the file for logging actions taken when attempting to perform an operation.
Abort	Requests that the graph builder return as soon as possible from its current task.
ShouldOperationContinue	Queries whether the current operation should continue.

Requirements

Header: Declared in Strmif.h; include Dshow.h.

Library: Use Strmiids.lib.