USER_POWER_POLICY 结构 (powrprof.h)
包含对用户的每个电源方案都唯一的电源策略设置。 此结构是 POWER_POLICY 结构的一部分。
语法
typedef struct _USER_POWER_POLICY {
ULONG Revision;
POWER_ACTION_POLICY IdleAc;
POWER_ACTION_POLICY IdleDc;
ULONG IdleTimeoutAc;
ULONG IdleTimeoutDc;
UCHAR IdleSensitivityAc;
UCHAR IdleSensitivityDc;
UCHAR ThrottlePolicyAc;
UCHAR ThrottlePolicyDc;
SYSTEM_POWER_STATE MaxSleepAc;
SYSTEM_POWER_STATE MaxSleepDc;
ULONG Reserved[2];
ULONG VideoTimeoutAc;
ULONG VideoTimeoutDc;
ULONG SpindownTimeoutAc;
ULONG SpindownTimeoutDc;
BOOLEAN OptimizeForPowerAc;
BOOLEAN OptimizeForPowerDc;
UCHAR FanThrottleToleranceAc;
UCHAR FanThrottleToleranceDc;
UCHAR ForcedThrottleAc;
UCHAR ForcedThrottleDc;
} USER_POWER_POLICY, *PUSER_POWER_POLICY;
成员
Revision
当前结构修订级别。 在使用USER_POWER_POLICY结构设置电源策略之前，通过调用 GetCurrentPowerPolicies 或 ReadPwrScheme 来设置此值。
IdleAc
一种POWER_ACTION_POLICY结构，用于定义系统在交流 (实用工具上运行时启动的系统电源操作，) 电源和系统空闲计时器过期。
IdleDc
一个POWER_ACTION_POLICY结构，用于定义在系统使用电池供电且系统空闲计时器过期时要启动的系统电源操作。
IdleTimeoutAc
在交流 (实用工具) 电源运行时，系统空闲计时器在系统空闲计时器过期之前，系统活动级别必须保持在空闲检测阈值以下的时间（以秒为单位）。
如果系统正在执行自动恢复，则忽略此成员，因为没有用户存在。 若要在应用程序执行任务时暂时保持系统运行，请使用 SetThreadExecutionState 函数。
IdleTimeoutDc
使用电池电源运行时，系统活动级别必须保持在空闲检测阈值以下的时间，然后系统空闲计时器过期（以秒为单位）。
如果系统正在执行自动恢复，则忽略此成员，因为没有用户存在。 若要在应用程序执行任务时暂时保持系统运行，请使用 SetThreadExecutionState 函数。
IdleSensitivityAc
系统活动级别，用于定义系统在交流 (实用工具) 电源运行时的空闲检测阈值，以百分比表示。
IdleSensitivityDc
系统活动级别，定义系统使用电池电源运行时空闲检测的阈值，以百分比表示。
ThrottlePolicyAc
当系统使用交流 (实用工具运行时使用的处理器动态限制策略) 电源。
ThrottlePolicyDc
当系统使用电池电源运行时要使用的处理器动态限制策略。
MaxSleepAc
系统在交流 (实用工具上运行时的最大系统睡眠状态) 电源。 此成员必须是 SYSTEM_POWER_STATE 枚举类型值之一。
MaxSleepDc
系统使用电池电源运行时的最大系统睡眠状态。 此成员必须是 SYSTEM_POWER_STATE 枚举类型值之一。
Reserved[2]
保留。
VideoTimeoutAc
当系统在交流 (实用工具) 电源运行时，显示器关闭前的时间（以秒为单位）。
VideoTimeoutDc
系统使用电池电源运行时显示器关闭前的时间（以秒为单位）。
SpindownTimeoutAc
当系统使用交流 (实用工具) 电源运行时，关闭固定磁盘驱动器的电源之前的时间（以秒为单位）。
SpindownTimeoutDc
当系统使用电池电源运行时，关闭固定磁盘驱动器的电源之前的时间（以秒为单位）。
OptimizeForPowerAc
如果此成员为 TRUE，则当指定被动冷却且系统在交流 (实用程序) 电源运行时，系统将打开冷却风扇并全速运行处理器。 这会导致操作系统偏向于使用风扇并全速运行处理器。
OptimizeForPowerDc
如果此成员为 TRUE，则当指定被动冷却并且系统使用电池电源运行时，系统将打开冷却风扇并全速运行处理器。 这会导致操作系统偏向于使用风扇并全速运行处理器。
FanThrottleToleranceAc
当系统在交流 (实用程序上运行时，在打开系统风扇以响应热事件之前，处理器可能被限制到的下限) 功率，以百分比表示。
FanThrottleToleranceDc
在系统使用电池电源运行时，在打开系统风扇以响应热事件之前，处理器可能被限制到的下限值，以百分比表示。
ForcedThrottleAc
计算机在 AC (实用工具上运行时由系统施加的处理器限制级别) 电源，以百分比表示。
ForcedThrottleDc
计算机使用电池电源运行时由系统施加的处理器限制级别，以百分比表示。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows XP [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
| 标头 | powrprof.h |