第一步是调用coinitializeex(coinit_apartmentthreaded)初始化com，再通过cocreateinstance(clsid_systemdeviceenum)获取icreatedevenum实例；接着用createclassenumerator分别传clsid_videoinputdevicecategory或clsid_audioinputdevicecategory枚举设备；遍历imoniker时通过bindtostorage获取ipropertybag读取l"description"获取友好名称，设备路径由getdisplayname获得；释放时须按ibasefilter→imoniker→icreatedevenum顺序，且couninitialize必须在所有对象释放后调用。
用 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 接口（不推荐，兼容性差）。
- 视频设备类别：
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 部分），至少让用户能区分设备。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
