IFilterMapper::EnumMatchingFilters

  • 项目

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

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 Values

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

DirectShow applications and DirectShow filters have different include file and link library requirements. See Setting Up the Build Environment for more information.

OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.

See Also

IFilterMapper Interface

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.