IFilterMapper2::CreateCategory 方法 (strmif.h)
[与此页面关联的功能 DirectShow 是旧版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获所取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能在 Media Foundation 中使用 MediaPlayer、 IMFMediaEngine 和 音频/视频捕获 ,而不是 DirectShow。 如果可能,Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]
方法 CreateCategory
将新的筛选器类别添加到注册表。
语法
HRESULT CreateCategory(
[in] REFCLSID clsidCategory,
[in] DWORD dwCategoryMerit,
[in] LPCWSTR Description
);
参数
[in] clsidCategory
类标识符 (新筛选器类别的 CLSID) 。
[in] dwCategoryMerit
类别的优点。 首先枚举具有较高优点的类别。
[in] Description
类别的描述性名称。
返回值
如果成功,则返回S_OK,或返回指示错误原因的 HRESULT 值。
注解
筛选器图管理器最初跳过优点值小于或等于 MERIT_DO_NOT_USE 的所有类别,以加快图形生成过程。 不应考虑用于播放的筛选器类别的优点应为 MERIT_DO_NOT_USE 或更少。
筛选器可以出现在一个或多个类别中, (例如,视频压缩器) 来限制搜索空间。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | strmif.h (包括 Dshow.h) |
Library | Strmiids.lib |
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈