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.
Methods
The IAMGraphBuilderCallback interface inherits the methods of the IUnknown interface.
In addition, IAMGraphBuilderCallback defines 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 | Strmif.h (include Dshow.h) |
|---|
| Library | Strmiids.lib |
|---|
See Also
- IAMFilterGraphCallback Interface
Send comments about this topic to Microsoft
Build date: 10/19/2009