|Microsoft DirectX 9.0|
Note The IFilterMapper interface is deprecated. Use IFilterMapper2 instead.
Adds a filter to the registry; the filter can then be enumerated.
HRESULT RegisterFilter( CLSID clsid, LPCWSTR Name, DWORD dwMerit );
[in] Globally unique identifier (GUID) of the filter.
[in] Descriptive name for the filter.
[in] Position in the order of enumeration. Filters with higher merit are enumerated first.
Returns an HRESULT value.
The merit (as defined by the dwMerit parameter) controls the order in which the filter graph manager tries filters when performing an operation as a result of a call to IGraphBuilder::Connect, IGraphBuilder::Render, or IGraphBuilder::RenderFile. The filter graph manager finds all filters registered with the correct media type and then tries the one with the highest merit, using other criteria in the registration to choose between filters with equal merit.