IFilterMapper::EnumMatchingFilters

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method provides an enumerator that enumerates registered filters that meet specified requirements.

Syntax

HRESULT EnumMatchingFilters(
  IEnumRegFilters** ppEnum,
  DWORD dwMerit,
  BOOL bInputNeeded,
  CLSID clsInMaj,
  CLSID clsInSub,
  BOOL bRender,
  BOOL bOutputNeeded,
  CLSID clsOutMaj,
  CLSID clsOutSub
);

Parameters

• ppEnum
  [out] Enumerator returned.

• dwMerit
  [in] Enumerate only filters with at least this merit.

• bInputNeeded
  TRUE if there must be at least one input pin.

• clsInMaj
  [in] Input major type required. Set to GUID_NULL if you do not care.

• clsInSub
  [in] Input subtype required. Set to GUID_NULL if you do not care.

• bRender
  [in] Option that specifies if the input must be rendered by this filter.

• bOutputNeeded
  TRUE if there must be at least one output pin.

• clsOutMaj
  [in] Output major type required. Set to GUID_NULL if you do not care.

• clsOutSub
  [in] Output subtype required. Set to GUID_NULL if you do not care.

Return Value

Returns an HRESULT value.

Remarks

Set the ppEnum parameter to be an enumerator for filters matching the requirements. For a description of merit values for the dwMerit parameter, see the IFilterMapper::RegisterFilter method.

Requirements

See Also

Reference

IFilterMapper Interface