IBaseFilter 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 IBaseFilter interface is the primary interface for DirectShow filters. All DirectShow filters must expose this interface. The Filter Graph Manager uses this interface to control filters. Applications can use this interface to enumerate pins and query for filter information, but should not use it to change the state of a filter. Instead, use the IMediaControl interface on the Filter Graph Manager.
Filter developers: Implement this interface on every DirectShow filter. The CBaseFilter base class implements this interface.
Inheritance
The IBaseFilter interface inherits from IMediaFilter. IBaseFilter also has these types of members:
Methods
The IBaseFilter interface has these methods.
| IBaseFilter::EnumPins The EnumPins method enumerates the pins on this filter. |
| IBaseFilter::FindPin The FindPin method retrieves the pin with the specified identifier. |
| IBaseFilter::JoinFilterGraph The JoinFilterGraph method notifies the filter that it has joined or left the filter graph. |
| IBaseFilter::QueryFilterInfo The QueryFilterInfo method retrieves information about the filter. |
| IBaseFilter::QueryVendorInfo The QueryVendorInfo method retrieves a string containing vendor information. |
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) |