Edit

IBaseFilter 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 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)

See also

IMediaFilter