CBaseFilter Class

Microsoft DirectShow 9.0

CBaseFilter Class

The CBaseFilter class is an abstract class for implementing filters. To implement a filter using this class, you must perform at least the following steps:

• Derive a new class from CBaseFilter.
• Include member variables that define the pins on the filter. The pins must inherit from the CBasePin class.
• Override the pure virtual method CBaseFilter::GetPin, which retrieves pins on the filter.
• Override the pure virtual method CBaseFilter::GetPinCount, which retrieves the number of pins.
• Provide methods for generating, processing, or rendering media samples.

Several base classes derive from CBaseFilter, including CSource, CBaseRenderer, and CTransformFilter. It is usually easier to implement a filter with one of these specialized classes, rather than use CBaseFilter directly.

Requirements

Header: Declared in Amfilter.h; include Streams.h.

Library: Use Strmbase.lib (retail builds) or Strmbasd.lib (debug builds).

Protected Member Variables
m_State	Current state of the filter.
m_pClock	Pointer to the filter's reference clock.
m_tStart	Reference time that corresponds to stream time 0.
m_clsid	Class identifier (CLSID) of the filter.
m_pLock	Pointer to a critical section that is used to serialize state changes.
m_pName	Filter name.
m_pGraph	Pointer to the filter graph manager.
m_pSink	Pointer to the IMediaEventSink interface on the filter graph manager.
m_PinVersion	Current version of the set of pins on this filter.
Public Methods
CBaseFilter	Constructor method.
~CBaseFilter	Destructor method.
StreamTime	Retrieves the current stream time. Virtual.
IsActive	Determines whether the filter is currently active (running or paused).
IsStopped	Determines whether the filter is currently stopped.
NotifyEvent	Sends an event notification to the filter graph manager.
GetFilterGraph	Retrieves a pointer to the filter graph manager.
ReconnectPin	Breaks an existing pin connection and reconnects it to the same pin, using a specified media type.
GetPinVersion	Retrieves a version number for the set of pins on this filter. Virtual.
IncrementPinVersion	Increments the version number on the set of pins.
GetSetupData	Retrieves the registration data for the filter. Virtual.
Pure Virtual Methods
GetPinCount	Retrieves the number of pins.
GetPin	Retrieves a pin.
IPersist Methods
GetClassID	Retrieves the class identifier.
IMediaFilter Methods
GetState	Retrieves the filter's state (running, stopped, or paused).
SetSyncSource	Sets a reference clock for the filter.
GetSyncSource	Retrieves the reference clock that the filter is using.
Stop	Stops the filter.
Pause	Pauses the filter.
Run	Runs the filter.
IBaseFilter Methods
EnumPins	Enumerates the pins on this filter.
FindPin	Retrieves the pin with the specified identifier.
QueryFilterInfo	Retrieves information about the filter.
JoinFilterGraph	Notifies the filter that it has joined or left a filter graph.
QueryVendorInfo	Retrieves a string containing vendor information.
IAMovieSetup Merthods
Register	Adds the filter to the registry.
Unregister	Removes the filter from the registry.