讲师中心 微信公众号
AI工具推荐 视频效率加速

C++ DirectShow怎么枚举系统中的音视频输入硬件

落敏同学_7523

落敏同学_7523

发布时间:2026-10-24 07:59:02

|

483人浏览过

|

来源于php中文网

原创

第一步是调用CoInitializeEx(COINIT_APARTMENTTHREADED)初始化COM,再通过CoCreateInstance(CLSID_SystemDeviceEnum)获取ICreateDevEnum实例;接着用CreateClassEnumerator分别传CLSID_VideoInputDeviceCategory或CLSID_AudioInputDeviceCategory枚举设备;遍历IMoniker时通过BindToStorage获取IPropertyBag读取L"Description"获取友好名称,设备路径由GetDisplayName获得;释放时须按IBaseFilter→IMoniker→ICreateDevEnum顺序,且CoUninitialize必须在所有对象释放后调用。

c++ directshow怎么枚举系统中的音视频输入硬件

用 ICreateDevEnum 获取设备枚举器是第一步

DirectShow 设备枚举依赖 COM,必须先初始化 COM 库(CoInitializeEx),再通过 CoCreateInstance 创建 ICreateDevEnum 实例。这个接口不是用来直接列设备的,而是用来获取更具体的枚举器——比如音视频输入设备各需不同子类枚举器。

常见错误是跳过 CoInitializeEx 或传错参数(比如用 COINIT_MULTITHREADED 却没处理线程模型匹配),导致后续 CoCreateInstance 返回 REGDB_E_CLASSNOTREG 或 CO_E_NOTINITIALIZED。

  • 必须用 COINIT_APARTMENTTHREADED(尤其在 UI 线程)
  • ICreateDevEnum 的 CLSID 是 CLSID_SystemDeviceEnum,别手写字符串
  • 调用后记得 AddRef 保存引用,否则可能被提前释放

区分 FindMoniker 的类别参数:音频 vs 视频输入

拿到 ICreateDevEnum 后,调用 CreateClassEnumerator,关键在第二个参数 dwType:视频输入用 CLSID_VideoInputDeviceCategory,音频输入用 CLSID_AudioInputDeviceCategory。这两个是预定义 GUID,不能互换,也不能用 CLSID_AudioRendererCategory 替代——后者是输出设备。

如果枚举结果为空,大概率是类别填错,或系统没启用对应设备(比如 BIOS 关了摄像头、USB 麦克风未插稳)。Windows 10/11 上部分 Realtek 声卡驱动会把麦克风注册在 CLSID_AudioInputDeviceCategory 下,但某些旧驱动可能漏注册,此时需 fallback 到 CLSID_AudioRendererCategory + 反向检查 IAMAudioInputMixer 接口(不推荐,兼容性差)。

立即学习“C++免费学习笔记(深入)”;

C++14
C++14

C++14 对 C++11 的修正与增强版本,适合旧系统维护和较老工具链兼容。

下载
  • 视频设备类别:CLSID_VideoInputDeviceCategory
  • 音频设备类别:CLSID_AudioInputDeviceCategory
  • 返回 S_FALSE 表示该类别下无设备,不是错误

从 IMoniker 提取友好名称和设备路径

枚举器返回的是 IEnumMoniker,遍历得到每个 IMoniker,再调用其 BindToObject 获取 IBaseFilter,进而用 IPersistPropertyBag::Load 或更简单的 IMoniker::GetDisplayName 拿显示名。但注意:GetDisplayName 返回的是内部路径(如 @device:pnp:\?pci#ven_8086&dev_9d71...),不是用户看到的“Logitech C920”。

真正可读的名称得靠 IMoniker::GetDisplayName 配合 ICreateDevEnum::CreateClassEnumerator 的 dwFlags 参数(设为 0),或者更可靠的方式:调用 IMoniker::BindToStorage 获取 IPropertyBag,再读 L"Description" 或 L"FriendlyName" 属性。有些设备(尤其是 USB 音频)只填了 Description,而 FriendlyName 为空。

  • 必读属性名:L"Description"(比 FriendlyName 更通用)
  • IPersistPropertyBag::Load 需要自己构造 IPropertyBag,不如用 IMoniker::BindToStorage 直接
  • 设备路径(GetDisplayName 结果)可用于后续 IGraphBuilder::AddSourceFilter

释放顺序和线程安全容易出问题

DirectShow 对象释放有隐含依赖:比如 IMoniker 必须在对应的 IBaseFilter 释放后才能安全释放;ICreateDevEnum 要最后释放。在多线程中,如果一个线程正在枚举,另一个线程调用了 CoUninitialize,会导致所有 COM 接口调用崩溃(AV 或 RPC_E_CHANGED_MODE)。

典型坑是把枚举逻辑封装成函数,局部变量存 IMoniker*,函数返回后直接释放——但此时 IBaseFilter 可能还没创建,IMoniker 还被内部引用着。稳妥做法是:枚举时把 IMoniker 和提取出的名称、路径一起存进结构体,之后统一管理生命周期。

  • 释放顺序:先 IBaseFilter → 再 IMoniker → 最后 ICreateDevEnum
  • 不要跨线程传递未 AddRef 的接口指针
  • CoUninitialize 必须在所有 DirectShow 对象释放后调用

设备名称和路径的提取逻辑看似简单,但不同厂商驱动对 PropertyBag 属性的实现差异很大,建议对空 Description 做 fallback 显示设备路径片段(比如截取 ven_XXXX&dev_YYYY 部分),至少让用户能区分设备。

热门AI工具

更多
DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

相关专题

更多
c++和c语言的区别有哪些
c++和c语言的区别有哪些

c++和c语言的区别:1、面向对象编程(OOP)支持不同;2、新增特性不同;3、标准库不同;4、编译方式不同;5、命名空间不同等等。想了解更多c++的相关内容,可以阅读本专题下面的文章。

2248

2024.03.14

c++和python学习顺序推荐
c++和python学习顺序推荐

一般建议先学习C++,再学习Python,因为这样可以逐步从较为底层的编程语言向更高级的语言过渡。想了解更多python的相关内容,可以阅读本专题下面的文章。

1019

2024.03.14

python和c++学习性价比分析
python和c++学习性价比分析

Python易于学习,广泛应用于Web开发、数据科学和人工智能等领域,但性能较低。C语言性能高,适用于对性能要求较高的场景,如游戏开发和系统编程,但学习曲线陡峭,错误处理复杂。想了解更多python的相关内容,可以阅读本专题下面的文章。

447

2024.03.14

c语言和c++一样吗
c语言和c++一样吗

c语言和c++是两种不同的编程语言,虽然有相似之处,但存在显著差异。c语言专注于过程式编程和系统级开发,以简洁、高效著称。c++作为c语言的超集,引入了面向对象编程,增强了代码组织和管理能力,但学习曲线也更陡峭。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

327

2024.03.14

c语言和c++先学哪个好
c语言和c++先学哪个好

初学者选择学习c语言还是c++语言,需要根据个人学习目标、背景以及编程兴趣和预期应用方向来决定。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

426

2024.03.14

c语言和c++的区别和联系
c语言和c++的区别和联系

c语言和c++是计算机科学领域应用广泛的编程语言。虽然它们有着相似的基础,但它们在语言类型、语法功能和内存管理方面存在着显著差异。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

600

2024.03.14

c++软件中文更改教程
c++软件中文更改教程

对于 ide,可通过打开设置,找到语言设置,选择中文,并保存更改。对于非 ide 应用程序,可查找设置或选项,选择语言设置,更改为中文,并保存更改。想了解更多c++的相关内容,可以阅读本专题下面的文章。

1409

2024.03.21

python和java和c++学习性价比分析
python和java和c++学习性价比分析

Python以其易学性、丰富的库和活跃的社区而著称,适合数据科学、人工智能和Web开发。Java以其跨平台性、企业级应用开发和Android应用开发而闻名。C++以其底层控制能力、高效性能和游戏开发而著称。选择哪种语言取决于个人兴趣、职业方向和特定需求。想了解更多python和java和c++的相关内容,可以阅读本专题下面的文章。

1217

2024.03.22

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

0

2026.10.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C++ Core Guidelines
C++ Core Guidelines

共0课时 | 0人学习

C++ Reference
C++ Reference

共0课时 | 0人学习

C++ 官方标准说明
C++ 官方标准说明

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn