Share via

SYSTEM_POWER_POLICY 结构 (winnt.h)

  • 项目

包含有关当前系统电源策略的信息。

语法

typedef struct _SYSTEM_POWER_POLICY {
  DWORD               Revision;
  POWER_ACTION_POLICY PowerButton;
  POWER_ACTION_POLICY SleepButton;
  POWER_ACTION_POLICY LidClose;
  SYSTEM_POWER_STATE  LidOpenWake;
  DWORD               Reserved;
  POWER_ACTION_POLICY Idle;
  DWORD               IdleTimeout;
  BYTE                IdleSensitivity;
  BYTE                DynamicThrottle;
  BYTE                Spare2[2];
  SYSTEM_POWER_STATE  MinSleep;
  SYSTEM_POWER_STATE  MaxSleep;
  SYSTEM_POWER_STATE  ReducedLatencySleep;
  DWORD               WinLogonFlags;
  DWORD               Spare3;
  DWORD               DozeS4Timeout;
  DWORD               BroadcastCapacityResolution;
  SYSTEM_POWER_LEVEL  DischargePolicy[NUM_DISCHARGE_POLICIES];
  DWORD               VideoTimeout;
  BOOLEAN             VideoDimDisplay;
  DWORD               VideoReserved[3];
  DWORD               SpindownTimeout;
  BOOLEAN             OptimizeForPower;
  BYTE                FanThrottleTolerance;
  BYTE                ForcedThrottle;
  BYTE                MinThrottle;
  POWER_ACTION_POLICY OverThrottled;
} SYSTEM_POWER_POLICY, *PSYSTEM_POWER_POLICY;

成员

Revision

当前结构修订。

PowerButton

POWER_ACTION_POLICY结构，用于定义在按下系统电源按钮时要启动的系统电源操作。

SleepButton

一种 POWER_ACTION_POLICY 结构，用于定义按下系统睡眠按钮时要启动的系统电源操作。

LidClose

POWER_ACTION_POLICY结构，用于定义关闭系统盖开关时要启动的系统电源操作。

LidOpenWake

最大功率状态 (最高 Sx 值) 打开盖子事件应从中唤醒系统。 此成员必须是 SYSTEM_POWER_STATE 枚举类型值之一。

Reserved

保留。

Idle

一种POWER_ACTION_POLICY结构，用于定义在系统空闲计时器过期时要启动的系统电源操作。

IdleTimeout

在系统空闲计时器过期之前，系统活动级别必须保持在空闲检测阈值以下的时间（以秒为单位）。

IdleSensitivity

定义空闲检测阈值的系统活动级别，以百分比表示。

DynamicThrottle

当前系统处理器动态限制策略。 此成员必须是 处理器性能控制策略常量中所述的值之一。

Spare2[2]

保留。

MinSleep

当前支持的最小系统睡眠状态 (最低 Sx 值) 。 此成员必须是 SYSTEM_POWER_STATE 枚举类型值之一。

MaxSleep

当前支持的最大系统睡眠状态 (最高 Sx 值) 。 此成员必须是 SYSTEM_POWER_STATE 枚举类型值之一。

ReducedLatencySleep

系统电源状态 (Sx 值) 在存在未完成的延迟要求时输入系统睡眠操作。 此成员必须是 SYSTEM_POWER_STATE 枚举类型值之一。 如果应用程序使用 LT_LOWEST_LATENCY 调用 RequestWakeupLatency ，则将使用 ReducedLatencySleep 代替 MaxSleep。

WinLogonFlags

此成员可以是零或WINLOGON_LOCK_ON_SLEEP (0x00000001) 。

Spare3

保留。

DozeS4Timeout

进入暂停状态和进入休眠睡眠状态之间的等待时间（以秒为单位）。 值为零表示永不休眠。

BroadcastCapacityResolution

当前电池容量变化的解决方法，该更改应导致系统收到系统电源状态更改事件的通知。

DischargePolicy[NUM_DISCHARGE_POLICIES]

SYSTEM_POWER_LEVEL结构的数组，用于定义在系统电池电量耗尽事件时要执行的操作。

VideoTimeout

显示器关闭前的时间（以秒为单位）。

VideoDimDisplay

如果此成员为 TRUE，则系统包括对显示调暗的支持。

VideoReserved[3]

保留。

SpindownTimeout

关闭固定磁盘驱动器电源之前的时间（以秒为单位）。

OptimizeForPower

如果此成员为 TRUE，则系统将在指定被动冷却时打开冷却风扇并全速运行处理器。 这会导致操作系统偏向于使用风扇和全速运行处理器。

FanThrottleTolerance

在打开系统风扇以响应热事件之前，处理器可能被限制到的下限，以百分比表示。

ForcedThrottle

由系统施加的处理器限制级别，以百分比表示。

MinThrottle

最小处理器限制级别，以百分比表示。

OverThrottled

一种POWER_ACTION_POLICY结构，用于定义在处理器限制无法充分降低系统温度时为响应热事件而启动的系统电源操作。

要求

要求 值
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
标头 winnt.h (包括 Windows.h)

另请参阅

CallNtPowerInformation

POWER_ACTION_POLICY

SYSTEM_POWER_LEVEL