Share via

IFilterMapper::RegisterFilter (Compact 2013)

  • Article

3/26/2014

This method 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.

The following predefined values exist for the dwMerit parameter. Other values, such as MERIT_NORMAL-1, can be used. Using the formula (MERIT_NORMAL+MERIT_UNLIKELY)/2 to calculate the merit value is advisable, because it leaves some low-order bits available for making even finer distinctions.

Value

Description

0x900000

Hardware renderer filter. Filters with this merit value are tried first.

MERIT_PREFERRED (0x800000)

Filter, such as a renderer, that is likely to complete the operation directly.

0x680000

MPEG decompression filter. These are tried before AVI decompressors because the latter require more time to determine if they work in the filter graph.

MERIT_NORMAL (0x600000)

Filter that may contribute to the completion of a connection. AVI decompression filters and splitter transform filters are registered to this value.

MERIT_UNLIKELY (0x400000)

Filter that may contribute to the completion of a connection (a color space conversion filter, for example). The filter graph manager uses this filter only if other options have failed. Register source filters with this value.

MERIT_DO_NOT_USE (0x200000)

Filter that will never contribute to the completion of a connection. Filters registered with this value (or less) will never be tried by the filter graph manager when automatically building a filter graph. Use this to register filters that must be added explicitly, either as part of a predefined filter graph or by adding them using IFilterGraph::AddFilter. Examples include tee filters or effects filters.

MERIT_HW_COMPRESSOR (0x100050)

Hardware compressor filter. Filters registered with this value will never be tried by the filter graph manager when automatically building a filter graph.

MERIT_SW_COMPRESSOR (0x100000)

Software compressor filter. Filters registered with this value will never be tried by the filter graph manager when automatically building a filter graph.

Requirements

Header

dshow.h

Library

Strmiids.lib

See Also

Reference

IFilterMapper Interface