IFilterMapper Interface (Windows Embedded CE 6.0)

1/6/2010

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

Windows Embedded CE	Windows CE 2.12 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

See Also

Reference

DirectShow Interfaces