通过

IFilterMapper：：RegisterFilter 方法 (strmif.h)

  • 项目

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

注意IFilterMapper 接口已弃用。 请改用 IFilterMapper2 。
 
将筛选器添加到注册表;然后可以枚举筛选器。

语法

HRESULT RegisterFilter(
  [in] CLSID   clsid,
  [in] LPCWSTR Name,
  [in] DWORD   dwMerit
);

参数

[in] clsid

全局唯一标识符 (筛选器的 GUID) 。

[in] Name

筛选器的描述性名称。

[in] dwMerit

按枚举顺序定位。 首先枚举具有较高优点的筛选器。

返回值

返回 HRESULT 值。

注解

由 dwMerit 参数定义的优点 () 控制筛选器图管理器在调用 IGraphBuilder：：Connect、IGraphBuilder：：Render 或 IGraphBuilder：：RenderFile 后执行操作时尝试筛选的顺序。 筛选器图管理器查找使用正确媒体类型注册的所有筛选器，然后尝试具有最高优点的筛选器，并使用注册中的其他条件在具有相同优点的筛选器之间进行选择。

要求

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

另请参阅

错误和成功代码

IFilterMapper 接口