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

另请参阅

POWER_ACTION_POLICY

POWER_POLICY