通过

iFilterMapper：：EnumMatchingFilters 方法 (strmif.h)

  • 项目

[与此页面关联的功能 DirectShow 是一项旧功能。 它已被 MediaPlayer、 IMFMediaEngine 和 媒体基金会中的音频/视频捕获取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获 ，而不是 DirectShow。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

注意IFilterMapper 接口已弃用。 请改用 IFilterMapper2 。
 
提供枚举器，枚举满足指定要求的已注册筛选器。

语法

HRESULT EnumMatchingFilters(
  [out] IEnumRegFilters **ppEnum,
  [in]  DWORD           dwMerit,
        BOOL            bInputNeeded,
  [in]  CLSID           clsInMaj,
  [in]  CLSID           clsInSub,
  [in]  BOOL            bRender,
  [in]  BOOL            bOututNeeded,
  [in]  CLSID           clsOutMaj,
  [in]  CLSID           clsOutSub
);

参数

[out] ppEnum

指向返回的枚举器的指针的地址。

[in] dwMerit

要枚举的筛选器的最小优点值。

bInputNeeded

指示是否必须至少有一个输入引脚的值; TRUE 表示至少需要一个输入引脚。

[in] clsInMaj

需要输入主要类型。 如果不在意，则设置为 GUID_NULL。

[in] clsInSub

需要输入子类型。 如果不在意，则设置为 GUID_NULL。

[in] bRender

指定筛选器是否必须呈现输入的标志; TRUE 表示必须。

[in] bOututNeeded

指示是否必须至少有一个输出引脚的值; TRUE 表示至少需要一个输出引脚。

[in] clsOutMaj

所需的输出主要类型。 如果不在意，则设置为 GUID_NULL。

[in] clsOutSub

需要输出子类型。 如果不在意，则设置为 GUID_NULL。

返回值

返回 HRESULT 值。

注解

将 ppEnum 参数设置为符合要求的筛选器的枚举器。 有关 dwMerit 参数的功绩值的说明，请参阅 IFilterMapper：：RegisterFilter 方法。

要求

要求 值
目标平台 Windows
标头 strmif.h (包括 Dshow.h)

另请参阅

错误和成功代码

IFilterMapper 接口