Share via

IFilterMapper::EnumMatchingFilters (Compact 2013)

  • Article

3/26/2014

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

Header

dshow.h

Library

Strmiids.lib

See Also

Reference

IFilterMapper Interface