IAMGraphBuilderCallback Interface

 
Microsoft DirectShow 9.0

IAMGraphBuilderCallback Interface

The IAMGraphBuilderCallback interface provides a callback mechanism during graph building.

To use this interface, implement the interface in your application or client object. Query the Filter Graph Manager for the IObjectWithSite interface and call the IObjectWithSite::SetSite method with a pointer to your implementation of the interface. The Filter Graph Manager calls the methods on this interface while it builds the graph, which gives the client the opportunity to modify the graph-building process.

The primary use for this interface is to configure the Video Mixing Renderer filter before it is connected. You can also use it reject a specific filter during graph building, such as a decoder filter.

In addition to the methods inherited from IUnknown, the IAMGraphBuilderCallback interface exposes the following methods.

Method Description
SelectedFilter Called when the Filter Graph Manager finds a candidate filter, but before it creates the filter.
CreatedFilter Called after the Filter Graph Manager creates a filter, but before it tries to connect the filter.

Requirements

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

Library: Use Strmiids.lib.

See Also