estructura SYSTEM_POWER_POLICY (winnt.h)
Contiene información sobre la directiva de energía del sistema actual.
Sintaxis
typedef struct _SYSTEM_POWER_POLICY {
DWORD Revision;
POWER_ACTION_POLICY PowerButton;
POWER_ACTION_POLICY SleepButton;
POWER_ACTION_POLICY LidClose;
SYSTEM_POWER_STATE LidOpenWake;
DWORD Reserved;
POWER_ACTION_POLICY Idle;
DWORD IdleTimeout;
BYTE IdleSensitivity;
BYTE DynamicThrottle;
BYTE Spare2[2];
SYSTEM_POWER_STATE MinSleep;
SYSTEM_POWER_STATE MaxSleep;
SYSTEM_POWER_STATE ReducedLatencySleep;
DWORD WinLogonFlags;
DWORD Spare3;
DWORD DozeS4Timeout;
DWORD BroadcastCapacityResolution;
SYSTEM_POWER_LEVEL DischargePolicy[NUM_DISCHARGE_POLICIES];
DWORD VideoTimeout;
BOOLEAN VideoDimDisplay;
DWORD VideoReserved[3];
DWORD SpindownTimeout;
BOOLEAN OptimizeForPower;
BYTE FanThrottleTolerance;
BYTE ForcedThrottle;
BYTE MinThrottle;
POWER_ACTION_POLICY OverThrottled;
} SYSTEM_POWER_POLICY, *PSYSTEM_POWER_POLICY;
Miembros
Revision
Revisión de la estructura actual.
PowerButton
Estructura POWER_ACTION_POLICY que define la acción de alimentación del sistema para iniciarse cuando se presiona el botón de encendido del sistema.
SleepButton
Estructura POWER_ACTION_POLICY que define la acción de alimentación del sistema para iniciarse cuando se presiona el botón de suspensión del sistema.
LidClose
Estructura POWER_ACTION_POLICY que define la acción de alimentación del sistema para iniciarse cuando se cierra el conmutador de tapa del sistema.
LidOpenWake
Estado de potencia máximo (valor Sx más alto) desde el que un evento de apertura de tapa debe reactivar el sistema. Este miembro debe ser uno de los SYSTEM_POWER_STATE valores de tipo de enumeración.
Reserved
Reservado.
Idle
Estructura de POWER_ACTION_POLICY que define la acción de energía del sistema para iniciarse cuando expira el temporizador de inactividad del sistema.
IdleTimeout
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, en segundos.
IdleSensitivity
Nivel de actividad del sistema que define el umbral para la detección de inactividad, expresado como un porcentaje.
DynamicThrottle
Directiva de limitación dinámica del procesador del sistema actual. Este miembro debe ser uno de los valores descritos en Constantes de directiva de control de rendimiento del procesador.
Spare2[2]
Reservado.
MinSleep
Actualmente se admite el estado mínimo de suspensión del sistema (valor Sx más bajo). Este miembro debe ser uno de los SYSTEM_POWER_STATE valores de tipo de enumeración.
MaxSleep
Actualmente se admite el estado máximo de suspensión del sistema (valor Sx más alto). Este miembro debe ser uno de los SYSTEM_POWER_STATE valores de tipo de enumeración.
ReducedLatencySleep
Estado de alimentación del sistema (valor Sx) para entrar en una acción de suspensión del sistema cuando hay requisitos de latencia pendientes. Este miembro debe ser uno de los SYSTEM_POWER_STATE valores de tipo de enumeración. Si una aplicación llama a RequestWakeupLatency con LT_LOWEST_LATENCY, se usará ReducedLatencySleep en lugar de MaxSleep.
WinLogonFlags
Este miembro puede ser cero o WINLOGON_LOCK_ON_SLEEP (0x00000001).
Spare3
Reservado.
DozeS4Timeout
Tiempo de espera entre entrar en el estado de suspensión y entrar en el estado de suspensión hibernar, en segundos. Un valor de cero indica que nunca hiberna.
BroadcastCapacityResolution
Resolución del cambio en la capacidad actual de la batería que debe hacer que el sistema reciba una notificación de un evento de cambio de estado de alimentación del sistema.
DischargePolicy[NUM_DISCHARGE_POLICIES]
Matriz de estructuras de SYSTEM_POWER_LEVEL que define las acciones que se realizarán en los eventos de descarga de la batería del sistema.
VideoTimeout
Tiempo antes de que se desactive la pantalla, en segundos.
VideoDimDisplay
Si este miembro es TRUE, el sistema incluye compatibilidad para atenuar la pantalla.
VideoReserved[3]
Reservado.
SpindownTimeout
El tiempo antes de encender las unidades de disco fijas está desactivada, en segundos.
OptimizeForPower
Si este miembro es TRUE, el sistema activará ventiladores de refrigeración y ejecutará el procesador a toda velocidad cuando se especifique la refrigeración pasiva. Esto hace que el sistema operativo esté sesgado hacia el uso del ventilador y la ejecución del procesador a toda velocidad.
FanThrottleTolerance
Límite inferior al que puede limitarse el procesador antes de encender ventiladores del sistema en respuesta a un evento térmico, expresado como porcentaje.
ForcedThrottle
El nivel de limitación del procesador que el sistema va a imponer, expresado como un porcentaje.
MinThrottle
Nivel mínimo de limitación del procesador, expresado como porcentaje.
OverThrottled
Estructura POWER_ACTION_POLICY que define la acción de alimentación del sistema para iniciarse en respuesta a un evento térmico cuando la limitación del procesador no puede reducir adecuadamente la temperatura del sistema.
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 | winnt.h (incluya Windows.h) |