Edit

IAMGraphBuilderCallback interface (strmif.h)

  • Article

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

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.

Inheritance

The IAMGraphBuilderCallback interface inherits from the IUnknown interface. IAMGraphBuilderCallback also has these types of members:

Methods

The IAMGraphBuilderCallback interface has these methods.

 
IAMGraphBuilderCallback::CreatedFilter

The Filter Graph Manager calls this method after it has created a filter, but before it attempts to connect the filter.
IAMGraphBuilderCallback::SelectedFilter

The Filter Graph Manager calls this method when it finds a candidate filter for the graph, but before it creates the filter.

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)

See also

IAMFilterGraphCallback Interface