MacOS自定义USB麦克风音频驱动无法覆盖默认驱动求助

我们正在为USB麦克风开发自定义音频驱动，用于对输入音频流进行简单处理（如均衡器EQs，类似Windows的APO）。目前已将基于SimpleAudioDriver的驱动分配至目标音频设备，但系统中出现两个设备：一个搭载自定义驱动，另一个使用默认驱动。尝试添加更多IOKitPersonalities提升probe score无效，日志显示原驱动与自定义驱动的probe score均为最大值100000。

当前info.plist内容如下：

<plist version="1.0">
<dict>
    <key>IOKitPersonalities</key>
    <dict>
        <key>SimpleAudioDriver</key>
        <dict>
            <key>idProduct</key>
            <integer>49456</integer>
            <key>idVendor</key>
            <integer>1130</integer>
            <key>CFBundleIdentifier</key>
            <string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
            <key>IOClass</key>
            <string>IOUserService</string>
            <key>IOMatchCategory</key>
            <string>SimpleAudioDriver</string>
            <key>IOProviderClass</key>
            <string>IOUSBDevice</string>
            <key>IOResourceMatch</key>
            <string>IOKit</string>
            <key>IOUserAudioDriverUserClientProperties</key>
            <dict>
                <key>IOClass</key>
                <string>IOUserUserClient</string>
                <key>IOUserClass</key>
                <string>IOUserAudioDriverUserClient</string>
            </dict>
            <key>IOUserClass</key>
            <string>SimpleAudioDriver</string>
            <key>IOUserServerName</key>
            <string>com.example.apple-samplecode.SimpleAudio.Driver</string>
            <key>SimpleAudioDriverUserClientProperties</key>
            <dict>
                <key>IOClass</key>
                <string>IOUserUserClient</string>
                <key>IOUserClass</key>
                <string>SimpleAudioDriverUserClient</string>
            </dict>
        </dict>
    </dict>
</dict>
</plist>

解决思路 #

• 调整驱动匹配层级，针对音频接口而非USB设备匹配
  默认USB音频驱动通常匹配IOAudioInterface或IOAudioEngine层级，而非顶层的IOUSBDevice。将IOProviderClass从IOUSBDevice改为IOAudioInterface，并添加音频设备专属的匹配键：

  <key>IOProviderClass</key>
  <string>IOAudioInterface</string>
  <key>IOAudioDeviceVendorID</key>
  <integer>1130</integer>
  <key>IOAudioDeviceProductID</key>
  <integer>49456</integer>
  

  这样你的驱动会直接匹配音频接口，而非整个USB设备，避免和默认驱动同时匹配不同层级的设备。

• 添加独占匹配属性，阻止其他驱动加载
  在你的IOKitPersonality字典中添加IOExclusive键并设为YES，告诉IOKit该驱动需要独占匹配的设备，阻止其他驱动（包括默认驱动）绑定到同一设备：

  <key>IOExclusive</key>
  <true/>
  

• 优化probe score的优先级逻辑
  虽然两者probe score都是100000，但可以明确添加IOProbeScore键并设置为100000，避免系统自动计算的歧义。同时确保你的驱动签名具有更高的优先级（如果是签名驱动），系统会优先选择签名更可信的驱动。

• 检查驱动的服务注册方式
  确认自定义驱动是作为替代而非附加音频设备存在。在用户态驱动实现中，确保正确接管原音频设备的所有功能，而非创建新的音频端点。参考Apple的IOUserAudioDriver示例，确保驱动正确继承并覆盖原设备的音频处理逻辑。

• 验证系统日志中的驱动加载顺序
  使用ioreg -l或查看system.log，确认默认驱动和自定义驱动的加载顺序。如果默认驱动先加载，可以调整驱动的IOResourceMatch或IOProviderClass匹配逻辑，让自定义驱动更早被IOKit识别。

内容的提问来源于stack exchange，提问作者kinaar