IFilterMapper::EnumMatchingFilters

Microsoft DirectX 8.1 (C++)

IFilterMapper::EnumMatchingFilters

Note The IFilterMapper interface is deprecated.

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] Address of a pointer to the enumerator returned.

dwMerit

[in] Minimum merit value of filters to enumerate.

bInputNeeded

Value indicating whether there must be at least one input pin; TRUE indicates at least one input pin is required.

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] Flag that specifies whether the filter must render the input; TRUE means that it must.

bOutputNeeded

[in] Value indicating whether there must be at least one output pin; TRUE indicates at least one output pin is required.

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.

See Also