Microsoft DirectX 9.0

IFilterMapper::RegisterFilter

Note   The IFilterMapper interface is deprecated. Use IFilterMapper2 instead.

Adds a filter to the registry; the filter can then be enumerated.

Syntax

HRESULT RegisterFilter(
    CLSID clsid,
    LPCWSTR Name,
    DWORD dwMerit
);

Parameters

clsid

[in] Globally unique identifier (GUID) of the filter.

Name

[in] Descriptive name for the filter.

dwMerit

[in] Position in the order of enumeration. Filters with higher merit are enumerated first.

Return Value

Returns an HRESULT value.

Remarks

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.

See Also