Delphi WinAPI SetThreadExecutionState - 防止系统在应用程序运行时进入睡眠状态或关闭显示器。

Delphi WinAPI SetThreadExecutionState - 防止系统在应用程序运行时进入睡眠状态或关闭显示器。

描述:使应用程序能够通知系统它正在使用,从而防止系统在应用程序运行时进入睡眠状态或关闭显示器。

原型:

EXECUTION_STATE SetThreadExecutionState(
  EXECUTION_STATE esFlags
);

esFlags 参数:

  • ES_AWAYMODE_REQUIRED  0x00000040
    • 启用离开模式。此值必须使用ES_CONTINUOUS指定。
    • 离开模式只能由媒体录制和媒体分发应用程序使用,这些应用程序必须在桌面计算机上执行关键的后台处理,而计算机似乎处于休眠状态。
  • ES_CONTINUOUS  0x80000000
    • 通知系统正在设置的状态应保持有效,直到下一个使用ES_CONTINUOUS和另一个状态标志的调用被清除。
  • ES_DISPLAY_REQUIRED  0x00000002
    • 通过重置显示器空闲计时器强制显示器打开。 Forces the display to be on by resetting the display idle timer.
  • ES_SYSTEM_REQUIRED  0x00000001
    • 通过重置系统空闲计时器强制系统处于工作状态。Forces the system to be in the working state by resetting the system idle timer.
  • ES_USER_PRESENT  0x00000004
    • 不支持此值。如果ES_USER_PRESENT与其他esFlags值组合,则调用将失败,并且不会设置任何指定的状态。

返回值:

  • 如果函数成功,则返回值为前一个线程执行状态。
  • 如果函数失败,返回值为空。

C++ 使用示例:

// Television recording is beginning. Enable away mode and prevent
// the sleep idle time-out.
//
SetThreadExecutionState(ES_CONTINUOUS | ES_SYSTEM_REQUIRED | ES_AWAYMODE_REQUIRED);

//
// Wait until recording is complete...
//

//
// Clear EXECUTION_STATE flags to disable away mode and allow the system to idle to sleep normally.
//
SetThreadExecutionState(ES_CONTINUOUS); 

Delphi 使用示例:

function SetThreadExecutionState(esFlags:EXECUTION_STATE ):DWORD;stdcall;external 'kernel32.dll';   //引用API函数

const
  ES_SYSTEM_REQUIRED = $00000001;
  ES_DISPLAY_REQUIRED =$00000002;
  ES_CONTINUOUS = $80000000;
begin
  SetThreadExecutionState(ES_SYSTEM_REQUIRED or ES_DISPLAY_REQUIRED or ES_CONTINUOUS);  //启动控制

  SetThreadExecutionState(ES_CONTINUOUS); //恢复
end;

  

  

  

 

 

创建时间:2020.11.03  更新时间:

 

posted on 2020-11-03 10:35  滔Roy  阅读(1589)  评论(1编辑  收藏  举报

导航