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　　更新时间：