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)

Consulte también

CallNtPowerInformation

POWER_ACTION_POLICY

SYSTEM_POWER_LEVEL