.NET 阻止系统睡眠/息屏

246 阅读4分钟

前言

本文介绍Windows系统设备下如何阻止系统睡眠/息屏,以及查看当前阻止睡眠/息屏的应用信息

powercfg /requests查看活动列表

在播放音乐时,我们会发现设置了系统电源管理-自动睡眠,计划不会生效,这个音频播放操作阻止了系统自动睡眠。但不会阻止息屏,所以Windows下一般屏幕关闭是不影响音频播放的

通过管理员CMD-powercfg /requests可以查看当前,应用程序和驱动程序电源请求相关列表:

这里看到是[DRIVER] Synaptics HD Audio,扬声器设备。

powercfg /requests详见 Powercfg 命令行选项 | Microsoft Learn,上面主要几个模式:

  • DIDPLAY 屏幕显示

  • SYSTEM 系统睡眠/休眠。

  • AWAYMODE 离开模式

阻止的可能有DRIVER、SERVICE,也可能是EXE。

比如服务使用阻止睡眠: [SERVICE] \Device\HarddiskVolume3\Program Files\Intel\Intel(R) Ready Mode Technology\IRMTService.exe,这是Intel提供的低功耗模式Intel® Ready Mode 技术 (Intel® RMT),基于这个状态可以在有需要时快速唤醒PC

基于上面几个模式,我们可以解析是哪些应用或者服务在活动、阻止睡眠/息屏。

.NET应用层阻止睡眠/息屏

上面这些阻止操作一般是系统应用实现的。我们开发的应用,也有阻止用户节能操作的场景

比如应用升级,我们想保障升级一次性完成,自动睡眠则会延长整个升级流程、造成不必要的风险。

[DllImport("kernel32.dll", CharSet = CharSet.Auto, SetLastError = true)]
private static extern EXECUTION_STATE SetThreadExecutionState(EXECUTION_STATE esFlags);
/// <summary>
/// 使应用程序能够通知系统它正在使用中,从而防止系统在应用程序运行时进入睡眠状态或关闭显示器。
/// 通知应用之后的状态
/// </summary>
[FlagsAttribute]
public enum EXECUTION_STATE : uint
{
    /// <summary>
    /// 通知系统正在设置的状态应保持有效,直到使用 ES_CONTINUOUS 的下一次调用和清除其他状态标志之一。
    /// </summary>
    ES_CONTINUOUS = 0x80000000,
    /// <summary>
    /// 防止显示器关闭
    /// </summary>
    ES_DISPLAY_REQUIRED = 0x00000002,
    /// <summary>
    /// 防止系统进入睡眠
    /// </summary>
    ES_SYSTEM_REQUIRED = 0x00000001
}

SetThreadExecutionState是WIN32 Winbase下的一个系统函数,给应用程序提供接口:通知系统它正在使用中,从而防止系统在应用程序运行时进入睡眠状态或关闭显示器。详见SetThreadExecutionState 函数 (winbase.h) - Win32 apps | Microsoft Learn

上面还有一个ES_AWAYMODE_REQUIRED未列出来,使用并不多,只能由多媒体应用使用,用于睡眠时执行关键后台处理。

另外,函数执行有返回状态值。如果函数成功,则返回值为上一个线程执行状态。

调用此函数,实现阻止系统睡眠的操作:

 /// <summary>
 /// 阻止系统睡眠/息屏
 /// </summary>
 public static EXECUTION_STATE PreventSleep()
 {
     return SetThreadExecutionState(EXECUTION_STATE.ES_CONTINUOUS | EXECUTION_STATE.ES_SYSTEM_REQUIRED | EXECUTION_STATE.ES_DISPLAY_REQUIRED);
 }
 
 /// <summary>
1/// 允许系统睡眠
1/// </summary>
1public static EXECUTION_STATE AllowSleep()
1{
1    return SetThreadExecutionState(EXECUTION_STATE.ES_CONTINUOUS);
1}

这里阻止了睡眠以及息屏的操作

.NET快速查询活动状态

上面是使用.NET在应用中阻止系统进行睡眠以及息屏。.NET还可以通过WIN32直接查询这些阻止请求的总状态,是否可执行睡眠、是否可执行息屏?

CallNtPowerInformation 函数能即时的获取当前系统电源策略状态值,详见 CallNtPowerInformation 函数 (powerbase.h) - Win32 apps | Microsoft Learn

[DllImport("Powrprof.dll", CharSet = CharSet.Auto, SetLastError = true)]
private static extern uint CallNtPowerInformation(
    SystemInformationClass information,
    IntPtr inputBuffer,
    uint inputBufferLength,
    IntPtr outputBuffer,
    uint outputBufferLength
);

封装一下,获取系统执行状态:

/// <summary>
/// 获取系统执行状态
/// 0表示无,可正常睡眠、息屏
/// 1表示阻止睡眠中,系统无法睡眠
/// 2表示阻止息屏中,系统无法息屏
/// 3表示阻止睡眠以及息屏中,系统无法睡眠、息屏
/// </summary>
/// <returns>返回系统执行状态,如果查询失败,返回<see cref="EXECUTION_STATE.ES_CONTINUOUS"/></returns>
public static EXECUTION_STATE GetSystemExecutionState()
{
      IntPtr ptr = Marshal.AllocHGlobal(sizeof(uint));
      if (CallNtPowerInformation(SystemInformationClass.SystemExecutionState,
              IntPtr.Zero, 0, ptr, sizeof(uint)) == 0)
      {
          var objectState = Marshal.PtrToStructure(ptr, typeof(uint));
          var stringState = objectState?.ToString();
          if (stringState != "0" && Enum.TryParse(stringState, out EXECUTION_STATE state))
          {
              return state;
            }
    }
    return EXECUTION_STATE.ES_CONTINUOUS;
}

所以获取这个状态,可用于那些即将执行睡眠/息屏的功能,在执行前可确认此操作能否正常执行,提升用户操作的准确性。

最后

如果你觉得这篇文章对你有帮助,不妨点个赞支持一下!你的支持是我继续分享知识的动力。如果有任何疑问或需要进一步的帮助,欢迎随时留言。

也可以加入微信公众号 [DotNet技术匠] 社区,与其他热爱技术的同行一起交流心得,共同成长!

优秀是一种习惯,欢迎大家留言学习!

作者:唐宋元明清2188

出处:cnblogs.com/kybs0/p/18624932

声明:网络内容,仅供学习,尊重版权,侵权速删,歉意致谢!