IFilterMapper Interface (Windows CE 5.0)
This interface is an abstraction that represents registered information about filters. This allows properties of filters to be looked up during loading.
When to Implement
This interface is implemented on the filter mapper and is not intended to be implemented by developers.
When to Use
This interface is used by filters to register and unregister themselves. This is handled in the base classes by the CBaseFilter::Register and CBaseFilter::Unregister member functions. It is also used by the filter graph manager to look up filters and determine their characteristics when building a filter graph to render a given media type.
Methods in Vtable Order
The following table shows the methods that appear in the Vtable beneath the standard COM methods inherited from IUnknown.
| Method | Description |
|---|---|
| RegisterFilter | Records the details of a filter in the registry. |
| RegisterFilterInstance | Registers an identifiable instance of a filter. |
| RegisterPin | Records the details of a pin in the registry. |
| IFilterMapper::RegisterPinType | Adds a type for the pin to the registry. |
| UnregisterFilter | Deletes a filter from the registry. |
| UnregisterFilterInstance | Deletes an identifiable instance of a filter. |
| UnregisterPin | Deletes a pin from the registry. |
| EnumMatchingFilters | Finds all filters matching specific requirements. |
Requirements
DirectShow applications and DirectShow filters have different include file and link library requirements. See Setting Up the Build Environment for more information.
OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.
See Also
Send Feedback on this topic to the authors