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结构设置电源策略之前,通过调用 GetCurrentPowerPoliciesReadPwrScheme 来设置此值。

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 成员) 系统使用电池供电时所定义的操作。

注解

DozeS4TimeoutAcDozeS4TimeoutDc 对应于 SYSTEM_POWER_POLICYDozeS4Timeout 成员。 调用 SetActivePwrScheme 函数以应用电源方案时,这些值将从计算机电源策略合并到系统电源策略。

要求

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

另请参阅

POWER_ACTION_POLICY

POWER_POLICY