windows上最可靠的设备枚举方案是使用core audio api的iaudioendpointenumerator，需正确初始化com、指定方向枚举、获取属性并释放资源；portaudio需先pa_initialize()且同线程调用，避免directsound后端失效。
Windows 上用 IAudioEndpointEnumerator 获取设备列表最可靠
Windows Core Audio API 是系统级方案，比 PortAudio 更底层、更稳定，尤其对新硬件（如 USB-C 音频、蓝牙 LE Audio）支持更及时。PortAudio 依赖其后端实现，Windows 上实际常走 WASAPI，但封装层会隐藏设备状态细节，比如“已拔出但未刷新”的设备仍可能出现在列表里。
关键步骤是初始化 COM、获取 IMMDeviceEnumerator、调用 EnumAudioEndpoints。注意必须用 eRender 或 eCapture 明确指定方向，混用会导致空列表或崩溃。
- 必须在主线程调用
CoInitializeEx(nullptr, COINIT_APARTMENTTHREADED)，否则枚举失败且无明确错误码 -
EnumAudioEndpoints返回的IMMDeviceCollection需逐个调用GetCount和Item，不能直接遍历指针数组 - 设备属性要用
IMMDevice::OpenPropertyStore+IPropertyStore::GetValue获取，PKEY_Device_FriendlyName和PKEY_AudioEndpoint_GUID是常用键 - 记得释放所有
IMMDevice、IPropertyStore指针，漏掉一个就内存泄漏
PortAudio 的 Pa_GetDeviceCount() 为什么返回 -1 或设备名为空？
这不是代码写错了，大概率是 PortAudio 初始化没做，或者跨线程调用了设备查询函数。PortAudio 要求先调用 Pa_Initialize()，且后续所有 API（包括设备枚举）必须在同一线程执行——哪怕只是读取 Pa_GetDeviceInfo(i) 也不行。
另一个常见原因是后端不匹配：Pa_GetHostApiInfo() 显示当前用的是 paDirectSound，但 Windows 10+ 默认禁用 DirectSound，此时设备数恒为 0；改用 paWASAPI 才能拿到真实设备。
立即学习“C++免费学习笔记（深入）”；
- 检查
Pa_Initialize()返回值，非 0 就别继续了，常见是paUnanticipatedHostError - 用
Pa_GetDefaultInputDevice()/Pa_GetDefaultOutputDevice()前，先确认Pa_GetDeviceCount() > 0 -
Pa_GetDeviceInfo(i)返回的指针可能为nullptr，必须判空；name字段不是 C++ string，是 const char*，可能指向内部缓冲区，别存裸指针 - 如果只想要设备名和 ID，别反复调用
Pa_GetDeviceInfo，缓存一次结果复用
设备 GUID 和 friendly name 在不同 API 中不一致怎么办？
Windows Core Audio 的 PKEY_AudioEndpoint_GUID 是全局唯一字符串，而 PortAudio 的 PaDeviceInfo::hostApiSpecificStreamInfo 不暴露这个字段，Pa_GetDefaultOutputDevice() 返回的索引也不是系统级 ID——这意味着你无法靠“名字相同”来跨 API 对齐设备。
真正可桥接的方式只有：在 Core Audio 中拿到设备的 DEVPKEY_Device_InstanceId（格式如 USB\VID_046D&PID_0825\6&12345678&0&0000），再用它去匹配 PortAudio 设备描述里的 PaWinWasapiDeviceInfo::deviceInterface（仅 WASAPI 后端有）。其他后端（如 ASIO）根本不提供实例 ID。
- 不要用设备名做唯一标识，重命名、多语言系统、驱动更新都会改名
- Core Audio 中的
IMMDevice::GetId()返回的是动态 ID（每次枚举可能变），不能持久化存储 - 若需保存用户选择，存
DEVPKEY_Device_InstanceId+ 方向（render/capture），下次启动时重新枚举并匹配 - PortAudio 本身不提供 InstanceId 查询，WASAPI 后端需强制转换
PaDeviceInfo::hostApiSpecificStreamInfo到PaWinWasapiDeviceInfo*
实时监听设备插拔需要轮询还是事件驱动？
Core Audio 支持事件回调（IMMNotificationClient），但 PortAudio 完全不提供对应机制。想做到“插上耳机立刻响应”，只能用 Core Audio 注册通知；若坚持用 PortAudio，只能定时调用 Pa_GetDeviceCount() 并比对设备名哈希——但这样有延迟、耗 CPU，且无法区分“设备启用/禁用”和“物理插拔”。
事件回调必须实现 OnDeviceStateChanged、OnDeviceAdded 等接口，并用 RegisterEndpointNotificationCallback 注册。注意回调在 COM MTA 线程触发，所有 UI 更新必须封送到主线程。
- 注册前确保
IMMDeviceEnumerator是全局存活对象，回调里不能释放它 -
OnDeviceAdded的 device ID 是临时字符串，需立即Copy或转成std::wstring存储 - PortAudio 没有热插拔通知，
Pa_IsStreamActive()也无法检测设备是否被拔掉，流可能卡住或静音 - 如果程序只用 PortAudio，建议每 2–3 秒轮询一次设备数，配合上次有效设备名做简单变化检测，够用但不优雅
