Export (0) Print
Expand All

IGraphBuilder Interface (Windows CE 5.0)

Windows CE 5.0
Send Feedback

This interface allows applications to call upon the filter graph manager to attempt to build a complete filter graph, or parts of a filter graph given only partial information, such as the name of a file or the interfaces of two separate pins. The filter mapper looks up filters in the registry to configure the filter graph in a meaningful way.

IGraphBuilder inherits from the IFilterGraph interface and exposes all its methods. For this reason, IFilterGraph should normally not be used directly.

When to Implement

This interface is implemented on the filter graph manager and is not intended for implementation by developers.

When to Use

Applications use this interface to create a filter graph, add filters to or remove filters from a filter graph, enumerate all the filters in a filter graph, and force connections when adding a filter. Filters typically use the interface to reconnect pins during the connection and negotiation process of building a filter graph.

Methods in Vtable Order

The following table shows the methods that appear in the Vtable beneath the standard COM methods inherited from IUnknown.

IFilterGraph methodDescription
AddFilterAdds a filter to the graph and gives it a name.
RemoveFilterRemoves a filter from the graph.
EnumFiltersProvides an enumerator for all filters in the graph.
FindFilterByNameFinds a filter that was added with a specified name.
ConnectDirectConnects the two IPin objects directly (without intervening filters).
ReconnectBreaks the existing pin connection and reconnects it to the same pin.
DisconnectDisconnects this pin, if connected.
SetDefaultSyncSourceSets the default synchronization source (a clock).
IGraphBuilder methodDescription
ConnectConnects two IPin objects. If they will not connect directly, this method connects them with intervening transforms.
RenderAdds a chain of filters to this output pin to render it.
RenderFileBuilds a filter graph that renders the specified file.
AddSourceFilterAdds a source filter to the filter graph for a specific file. The IGraphBuilder::RenderFile method calls this to find the source filter.
SetLogFileSets the log file into which actions taken in attempting to perform an operation are logged.


DirectShow applications and DirectShow filters have different include file and link library requirements. See Setting Up the Build Environment for more information.

Pocket: Windows Mobile 5.0 and later
Smartphones: Windows Mobile 5.0 and later
OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.

See Also

DirectShow Interfaces

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.

© 2014 Microsoft