IFilterMapper::EnumMatchingFilters

Windows CE .NET

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.

Show: