Share via


IFilterMapper Interface

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/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
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

See Also

Reference

DirectShow Interfaces