MACHINE_POWER_POLICY 结构 (powrprof.h)
包含计算机上每个电源方案唯一的计算机电源策略设置。 此结构是 POWER_POLICY 结构的一部分。
语法
typedef struct _MACHINE_POWER_POLICY {
ULONG Revision;
SYSTEM_POWER_STATE MinSleepAc;
SYSTEM_POWER_STATE MinSleepDc;
SYSTEM_POWER_STATE ReducedLatencySleepAc;
SYSTEM_POWER_STATE ReducedLatencySleepDc;
ULONG DozeTimeoutAc;
ULONG DozeTimeoutDc;
ULONG DozeS4TimeoutAc;
ULONG DozeS4TimeoutDc;
UCHAR MinThrottleAc;
UCHAR MinThrottleDc;
UCHAR pad1[2];
POWER_ACTION_POLICY OverThrottledAc;
POWER_ACTION_POLICY OverThrottledDc;
} MACHINE_POWER_POLICY, *PMACHINE_POWER_POLICY;
成员
Revision
当前结构修订级别。 在使用MACHINE_POWER_POLICY结构设置电源策略之前,通过调用 GetCurrentPowerPolicies 或 ReadPwrScheme 来设置此值。
MinSleepAc
使用交流电源运行时,最低系统电源状态 (最低 Sx 值) 进入系统睡眠操作。 此成员必须是 SYSTEM_POWER_STATE 枚举类型值之一。
MinSleepDc
使用电池电源运行时,系统电源状态 (最低 Sx 值) 进入系统睡眠操作。 此成员必须是 SYSTEM_POWER_STATE 枚举类型值之一。
ReducedLatencySleepAc
最大系统电源状态 (最高 Sx 值,) 在交流电源运行时以及存在未完成的延迟要求时进入系统睡眠操作。 此成员必须是 SYSTEM_POWER_STATE 枚举类型值之一。 如果应用程序使用 LT_LOWEST_LATENCY 调用 RequestWakeupLatency ,则 使用 ReducedLatencySleepAc 代替 MaxSleepAc。
ReducedLatencySleepDc
最大系统电源状态 (最高 Sx 值,) 在电池电源运行时以及存在未完成的延迟要求时进入系统睡眠操作。 此成员必须是 SYSTEM_POWER_STATE 枚举类型值之一。 如果应用程序使用 LT_LOWEST_LATENCY 调用 RequestWakeupLatency ,则 使用 ReducedLatencySleepAc 代替 MaxSleepAc。
DozeTimeoutAc
忽略此成员。
DozeTimeoutDc
忽略此成员。
DozeS4TimeoutAc
当系统使用交流电源运行时,进入暂停状态和进入休眠睡眠状态之间的等待时间(以秒为单位)。 值为零表示永不休眠。
DozeS4TimeoutDc
当系统使用电池电源运行时,在进入暂停状态和进入休眠睡眠状态之间等待的时间(以秒为单位)。 值为零表示永不休眠。
MinThrottleAc
当系统使用交流电源运行时,在被过度限制之前允许的最小节流设置。 热条件是低于最低设置的唯一原因。 当处理器过度受限时,系统将启动 OverThrottledAc 策略。 请注意,电源策略管理器具有硬编码策略,用于在任何热区域指示关键热状况时启动 CriticalShutdownOff。 范围:0-100。
MinThrottleDc
当系统使用电池电源运行时,在被过度调节之前允许的最小节流设置。 热条件是低于最低设置的唯一原因。 当处理器过度受限时,系统将启动 OverThrottledDc 策略。 请注意,电源策略管理器具有硬编码策略,用于在任何热区域指示关键热状况时启动 CriticalShutdownOff。 范围:0-100。
pad1[2]
保留。
OverThrottledAc
一种 POWER_ACTION_POLICY 结构,用于定义当处理器被过度 (时要执行的操作,如 MinThrottleAc 成员) 系统使用交流电源运行时所定义的那样。
OverThrottledDc
一种 POWER_ACTION_POLICY 结构,用于定义当处理器变得过度 (时要执行的操作,如 MinThrottleDc 成员) 系统使用电池供电时所定义的操作。
注解
DozeS4TimeoutAc 和 DozeS4TimeoutDc 对应于 SYSTEM_POWER_POLICY 的 DozeS4Timeout 成员。 调用 SetActivePwrScheme 函数以应用电源方案时,这些值将从计算机电源策略合并到系统电源策略。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
标头 | powrprof.h |