Windows上最可靠的方式是通过Core Audio API的IMMDeviceEnumerator::EnumAudioEndpoints()枚举音频端点设备,需指定eRender或eCapture方向,调用GetState()判断驱动状态,并读取PKEY_Device_State属性(值为1表示物理连接),同时实现IMMNotificationClient监听OnDeviceStateChanged事件以实时响应插拔。

Windows平台用IMMDeviceEnumerator枚举音频端点设备
Windows上最可靠的方式是通过Core Audio API获取系统音频设备状态,而不是依赖注册表或文件系统。关键在于区分“设备是否存在”和“设备是否已连接”——后者需检查DEVICE_STATE_ACTIVE与物理插拔状态的组合。
实操要点:
-
IMMDeviceEnumerator::EnumAudioEndpoints()传入eRender(耳机)或eCapture(麦克风)获取对应设备列表 - 对每个
IMMDevice调用GetState(),返回值为DEVICE_STATE_ACTIVE仅表示驱动加载成功,不等于物理连接 - 必须额外调用
IMMDevice::OpenPropertyStore()读取PKEY_Device_State属性,值为1才代表当前已连接(注意:该值在Win10 1903+才稳定支持) - 若目标是检测“刚插入/拔出”,需实现
IMMNotificationClient接口监听OnDeviceStateChanged事件
Linux下读取/proc/asound/cards和sysfs节点不可靠
Linux没有统一的“耳机插入”信号抽象层,ALSA本身不暴露插拔事件,/proc/asound/cards只反映驱动加载状态,无法区分物理连接与否。
更可行的做法:
立即学习“C++免费学习笔记(深入)”;
组合式C++代码评审方案,融合静态分析、AI推理、多轮迭代评审和C++专项检查,适用于PR审查、增量代码审查、全项目评审和代码质量评分,触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 检查
/sys/class/sound/card*/codec#*/jack目录是否存在并包含headphone或mic子目录(取决于声卡驱动是否支持jack detection) - 读取
/sys/class/sound/card*/codec#*/jack/*/state,内容为"connected"或"disconnected"(但很多Realtek ALC芯片不提供该接口) - 用
udev监听SOUND子系统事件:udevadm monitor --subsystem-match=sound --property,观察NAME变化或DEVPATH增删,但仅对USB音频设备稳定 - 实际项目中建议退而求其次:用
pacmd list-sinks或pactl list sources short判断pulseaudio是否列出可用设备,并结合amixer -c0 get Capture看录制通道是否可调(有静音但能调节通常意味着麦克风已接入)
macOS用AudioObjectGetPropertyData查kAudioHardwarePropertyDevices
macOS的Core Audio将耳机和麦克风统一看作AudioDeviceID,但“连接状态”需分两层判断:设备是否存在 + 是否启用为默认输入/输出。
关键步骤:
- 调用
AudioObjectGetPropertyData获取所有设备ID列表,再对每个ID查询kAudioDevicePropertyDeviceName和kAudioDevicePropertyTransportType(值为kAudioDeviceTransportTypeUSB或kAudioDeviceTransportTypeBuiltIn) - 耳机是否生效,重点看
kAudioHardwarePropertyDefaultOutputDevice返回的ID是否属于扬声器类设备(名称含"Headphones"、"Line Out"或kAudioDevicePropertyNominalSampleRate非0) - 麦克风是否就绪,检查
kAudioHardwarePropertyDefaultInputDevice,再确认该设备的kAudioDevicePropertyInputIsAvailable属性值为TRUE(注意:此属性在某些外置USB麦上始终返回FALSE,需配合AudioDeviceAddIOProc尝试启动采集流来验证) - 无后台监听机制,如需实时响应,必须用
AudioObjectAddPropertyListener注册kAudioHardwarePropertyDevices和kAudioHardwarePropertyDefaultInputDevice变更回调
跨平台方案别硬套,优先用系统级音频服务状态
试图用C++直接轮询硬件状态容易陷入驱动兼容性泥潭。真实项目中更稳健的路径是绕过底层检测,转而依赖系统音频服务反馈:
- Windows:调用
IAudioEndpointVolume::GetMute()前先QueryInterface到ISimpleAudioVolume,失败即说明设备不存在或未激活 - Linux:执行
aplay -l | grep -q "card.*[[:space:]]*:"确认ALSA基础可用,再用parec --list-sources | grep -q "state: RUNNING"判断pulseaudio是否正在从某源采集(间接证明麦克风通路正常) - macOS:运行
system_profiler SPAudioDataType | grep -A5 "Output:"解析输出设备列表,比自己调Core Audio API更少出错 - 所有平台都应避免每秒多次轮询——插拔事件本质是异步的,主动轮询既耗资源又不准,正确做法是绑定系统事件(Windows MMDevice, Linux udev, macOS AudioObject监听)
真正难的不是“怎么查”,而是“查到之后怎么定义‘已连接’:是驱动加载?默认设备切换?还是能实际播放/录音?这三者在不同场景下含义完全不同。

















