 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
This interface abstracts an object that has typed input and output connections and can be aggregated dynamically.
All DirectShow filters expose this interface.
Because the IBaseFilterinterface derives from the IMediaFilterinterface, it inherits IPersist.
When to Implement
Implement this interface on every DirectShow filter. It is recommended that you use the CBaseFilterclass library to implement this interface.
When to Use
The filter graph manager is the primary user of this interface.
Applications or other filters can use IBaseFiltermethods directly to enumerate or retrieve pins or to get vendor information, but should not use any methods derived from IMediaFilterto control media streaming (use the IMediaControlmethods on the filter graph manager instead).
Methods in Vtable Order
The following tables show the methods that appear in the Vtable beneath the standard COM methods inherited from IUnknown.
| IMediaFilter method | Description |
|---|---|
|
Informs the filter to transition to the new (stopped) state. |
|
|
Informs the filter to transition to the new (paused) state. |
|
|
Informs the filter to transition to the new (running) state. |
|
|
Determines the state of the filter. |
|
|
Identifies the reference clock to which the filter should synchronize activity. |
|
|
Retrieves the current reference clock (or NULL if there is no clock). Passes a time value to synchronize independent streams. |
| IBaseFilter method | Description |
|---|---|
|
Enumerates the specified pins available on this filter. |
|
|
Retrieves a pointer to the pin with the specified identifier. |
|
|
Retrieves information about the specified filter. |
|
|
Notifies a filter that it has joined a filter graph. |
|
|
Retrieves optional information supplied by a vendor for the specified filter. |
Requirements
| Windows Embedded CE | Windows CE 2.12 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |
| Note | Microsoft DirectShow applications and DirectShow filters have
different include file and Library requirements
For more information, see Setting Up the Build Environment |