IAMFilterGraphCallback interface (strmif.h)
[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 IAMFilterGraphCallback 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. During graph building, if the Filter Graph Manager fails to render a pin, it calls the UnabletoRender method. The client can then take appropriate action, such as providing an error message for the user or registering a new filter.
Inheritance
The IAMFilterGraphCallback interface inherits from the IUnknown interface. IAMFilterGraphCallback also has these types of members:
Methods
The IAMFilterGraphCallback interface has these methods.
| IAMFilterGraphCallback::UnableToRender The UnableToRender method is called by the Filter Graph Manager if it cannot find any combination of filters to render the specified pin. |
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) |