IFilterMapper::EnumMatchingFilters
A version of this page is also available for
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
| Windows Embedded CE | Windows CE 2.12 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |
| Note | Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements For more information, see Setting Up the Build Environment, Version 2.12 requires DXPAK 1.0 or later |