estructura USER_POWER_POLICY (powrprof.h)
Contiene la configuración de directiva de energía que son únicas para cada esquema de energía para un usuario. Esta estructura forma parte de la estructura POWER_POLICY .
Sintaxis
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;
Miembros
Revision
Nivel de revisión de la estructura actual. Establezca este valor llamando a GetCurrentPowerPolicies o ReadPwrScheme antes de usar una estructura de USER_POWER_POLICY para establecer la directiva de energía.
IdleAc
Estructura POWER_ACTION_POLICY que define la acción de alimentación del sistema para iniciarse cuando el sistema se ejecuta en la alimentación de CA (utilidad) y el temporizador de inactividad del sistema expira.
IdleDc
Estructura POWER_ACTION_POLICY que define la acción de alimentación del sistema para iniciarse cuando el sistema se está ejecutando en batería y el temporizador de inactividad del sistema expira.
IdleTimeoutAc
El tiempo que el nivel de actividad del sistema debe permanecer por debajo del umbral de detección de inactividad antes de que expire el temporizador de inactividad del sistema cuando se ejecuta en la alimentación de CA (utilidad), en segundos.
Este miembro se omite si el sistema está realizando una reanudación automatizada porque no hay ningún usuario presente. Para mantener temporalmente el sistema en ejecución mientras una aplicación realiza una tarea, use la función SetThreadExecutionState .
IdleTimeoutDc
El tiempo que el nivel de actividad del sistema debe permanecer por debajo del umbral de detección de inactividad antes de que expire el temporizador de inactividad del sistema cuando se ejecuta en la energía de la batería, en segundos.
Este miembro se omite si el sistema está realizando una reanudación automatizada porque no hay ningún usuario presente. Para mantener temporalmente el sistema en ejecución mientras una aplicación realiza una tarea, use la función SetThreadExecutionState .
IdleSensitivityAc
El nivel de actividad del sistema que define el umbral para la detección de inactividad cuando el sistema se ejecuta en la alimentación de CA (utilidad), expresado como un porcentaje.
IdleSensitivityDc
El nivel de actividad del sistema que define el umbral para la detección de inactividad cuando el sistema se ejecuta en la energía de la batería, expresado como un porcentaje.
ThrottlePolicyAc
La directiva de limitación dinámica del procesador que se va a usar cuando el sistema se ejecuta en la alimentación de CA (utilidad).
ThrottlePolicyDc
La directiva de limitación dinámica del procesador que se va a usar cuando el sistema se está ejecutando con batería.
MaxSleepAc
Estado máximo de suspensión del sistema cuando el sistema se ejecuta en la alimentación de CA (utilidad). Este miembro debe ser uno de los SYSTEM_POWER_STATE valores de tipo de enumeración.
MaxSleepDc
El estado máximo de suspensión del sistema cuando el sistema se está ejecutando en la energía de la batería. Este miembro debe ser uno de los SYSTEM_POWER_STATE valores de tipo de enumeración.
Reserved[2]
Reservado.
VideoTimeoutAc
El tiempo antes de que se apague la pantalla cuando el sistema se ejecuta en la alimentación de CA (utilidad), en segundos.
VideoTimeoutDc
El tiempo antes de que la pantalla se apague cuando el sistema se está ejecutando en batería, en segundos.
SpindownTimeoutAc
El tiempo anterior a la alimentación en unidades de disco fijas se apaga cuando el sistema se ejecuta en la alimentación de CA (utilidad), en segundos.
SpindownTimeoutDc
El tiempo antes de encender las unidades de disco fijas se apaga cuando el sistema se está ejecutando con batería, en segundos.
OptimizeForPowerAc
Si este miembro es TRUE, el sistema encenderá ventiladores de refrigeración y ejecutará el procesador a toda velocidad cuando se especifica la refrigeración pasiva y el sistema se ejecuta en la alimentación de CA (utilidad). Esto hace que el sistema operativo esté sesgado hacia el uso del ventilador y la ejecución del procesador a toda velocidad.
OptimizeForPowerDc
Si este miembro es TRUE, el sistema encenderá ventiladores de refrigeración y ejecutará el procesador a toda velocidad cuando se especifica la refrigeración pasiva y el sistema se está ejecutando en la energía de la batería. Esto hace que el sistema operativo esté sesgado hacia el uso del ventilador y la ejecución del procesador a toda velocidad.
FanThrottleToleranceAc
El límite inferior que el procesador puede limitarse a antes de encender ventiladores del sistema en respuesta a un evento térmico mientras el sistema está funcionando en la alimentación de CA (utilidad), expresado como un porcentaje.
FanThrottleToleranceDc
El límite inferior que el procesador puede limitarse a antes de encender ventiladores del sistema en respuesta a un evento térmico mientras el sistema funciona con la energía de la batería, expresado como un porcentaje.
ForcedThrottleAc
El nivel de limitación del procesador que el sistema debe imponer mientras el equipo se ejecuta en la alimentación de CA (utilidad), expresado como un porcentaje.
ForcedThrottleDc
El nivel de limitación del procesador que el sistema debe imponer mientras el equipo está funcionando con batería, expresado como un porcentaje.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Encabezado | powrprof.h |