IFilterMapper2 interface (strmif.h)

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

Registers and unregisters filters, and locates filters in the registry. The Filter Mapper helper object implements this interface.

Filters use this interface to register and unregister themselves. When the filter graph manager builds a filter graph, it uses this interface to look up filters and determine their characteristics. Applications can also use this interface to look up filters. For more information, see Using the Filter Mapper and How to Register DirectShow Filters.

Inheritance

The IFilterMapper2 interface inherits from the IUnknown interface. IFilterMapper2 also has these types of members:

Methods

The IFilterMapper2 interface has these methods.

 
IFilterMapper2::CreateCategory

The CreateCategory method adds a new filter category to the registry.
IFilterMapper2::EnumMatchingFilters

The EnumMatchingFilters method enumerates registered filters that meet specified requirements.
IFilterMapper2::RegisterFilter

The RegisterFilter method adds filter information to the registry.
IFilterMapper2::UnregisterFilter

The UnregisterFilter method removes filter information from the registry.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header strmif.h (include Dshow.h)