UWP应用无法覆盖系统亮度：获取BrightnessOverride实例报错

我之前也踩过这个坑，结合UWP亮度控制的实际开发经验，给你几个排查和解决的方向：

1. 补全权限的完整流程 #

你已经在清单里勾选了「System Management」权限，但UWP的受限权限还有两个关键步骤不能漏：

• 手动去Windows设置确认权限：设置 > 隐私和安全性 > 系统管理，找到你的应用，确保权限开关是打开的
• 代码里必须主动请求权限，不能直接跳过这一步获取实例：

  var accessStatus = await BrightnessOverride.RequestAccessAsync();
  if (accessStatus != BrightnessOverrideAccessStatus.Allowed)
  {
      // 提示用户去设置开启权限
      return;
  }
  

2. 调整调用时机 #

BrightnessOverride.GetDefaultForSystem() 需要应用处于前台完全激活状态才能正常工作，如果在应用初始化早期（比如App.xaml.cs的OnLaunched里还没加载完UI）调用，大概率会抛出E_FAIL异常。建议把调用逻辑放在页面的Loaded事件里，或者等应用激活完成后再执行。

3. 尝试切换到视图级别的亮度覆盖 #

系统级的GetDefaultForSystem()对硬件和权限要求更高，有些设备（比如部分笔记本、外接显示器）可能不支持全局系统亮度覆盖。你可以先试试视图级别的方法，看是否能正常运行：

var bo = BrightnessOverride.GetForCurrentView();

如果这个能正常获取实例，说明你的设备仅支持当前应用视图的亮度调整，而非系统全局。

4. 排查硬件与驱动问题 #

E_FAIL异常有时候也和硬件兼容性有关：

• 更新你的显示适配器驱动到最新版本
• 确认设备本身支持软件调节亮度（比如部分台式机显示器只能手动物理调节，不支持系统API控制）

5. 获取更精准的错误信息 #

捕获异常时，查看COMException的ErrorCode属性（转成十六进制），能帮你定位更具体的问题：

catch (COMException ex)
{
    Debug.WriteLine($"具体错误码: 0x{ex.ErrorCode:X8}, 消息: {ex.Message}");
}

比如错误码如果是0x80070005（E_ACCESSDENIED），说明还是权限问题；其他码可以对应Win32错误码进一步排查。

给你一个完整的测试代码示例：

private async void MainPage_Loaded(object sender, RoutedEventArgs e)
{
    try
    {
        // 1. 先请求权限
        var accessStatus = await BrightnessOverride.RequestAccessAsync();
        if (accessStatus != BrightnessOverrideAccessStatus.Allowed)
        {
            Debug.WriteLine("亮度控制权限未授权，请前往设置开启");
            return;
        }

        // 2. 尝试获取实例（系统级不行就换视图级）
        var bo = BrightnessOverride.GetDefaultForSystem();
        // var bo = BrightnessOverride.GetForCurrentView();

        // 3. 设置亮度并启动覆盖
        bo.SetBrightnessPercentage(0.7, DisplayBrightnessOverrideOptions.None);
        bo.StartOverride();
        Debug.WriteLine("亮度覆盖已启动");
    }
    catch (COMException ex)
    {
        Debug.WriteLine($"COM异常: 0x{ex.ErrorCode:X8} - {ex.Message}");
    }
}

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