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) |