estructura SYSTEM_POWER_STATUS (winbase.h)

  • Artículo

Contiene información sobre el estado de energía del sistema.

Sintaxis

typedef struct _SYSTEM_POWER_STATUS {
  BYTE  ACLineStatus;
  BYTE  BatteryFlag;
  BYTE  BatteryLifePercent;
  BYTE  SystemStatusFlag;
  DWORD BatteryLifeTime;
  DWORD BatteryFullLifeTime;
} SYSTEM_POWER_STATUS, *LPSYSTEM_POWER_STATUS;

Miembros

ACLineStatus

Estado de alimentación de CA. Este miembro puede ser uno de los siguientes valores.

Value Significado
0
 Sin conexión
1
 En línea
255
 Estado Desconocido

BatteryFlag

Estado de carga de la batería. Este miembro puede contener una o varias de las marcas siguientes.

Value Significado
1
 Alta: la capacidad de la batería es superior al 66 por ciento.
2
 Baja: la capacidad de la batería es inferior al 33 por ciento.
4
 Crítico: la capacidad de la batería es inferior a cinco por ciento.
8
 Carga
128
 Sin batería del sistema
255
 Estado desconocido: no se puede leer la información de la marca de batería.
 

El valor es cero si la batería no se carga y la capacidad de la batería está entre baja y alta.

BatteryLifePercent

Porcentaje de carga completa de la batería restante. Este miembro puede ser un valor del intervalo entre 0 y 100 o 255 si el estado es desconocido.

SystemStatusFlag

Estado del ahorro de batería. Para participar en la conservación de la energía, evite las tareas que consumen muchos recursos cuando el ahorro de batería esté encendido. Para recibir una notificación cuando cambie este valor, llame a la función RegisterPowerSettingNotification con el GUID de configuración de energía, GUID_POWER_SAVING_STATUS.

Value Significado
0
 El ahorro de batería está apagado.
1
 Ahorro de batería encendido. Ahorre energía siempre que sea posible.
 
Nota Esta marca y el GUID de GUID_POWER_SAVING_STATUS se introdujeron en Windows 10. Esta marca se reservó anteriormente, denominada Reserved1, y tenía un valor de 0.
 
Para obtener información general sobre el ahorro de batería, consulte ahorro de batería (en las directrices del componente de hardware).

BatteryLifeTime

Número de segundos de duración restante de la batería, o –1 si se desconocen los segundos restantes o si el dispositivo está conectado a la alimentación de CA.

BatteryFullLifeTime

Número de segundos de duración de la batería cuando se carga completa, o –1 si se desconoce la duración completa de la batería o si el dispositivo está conectado a la alimentación de CA.

Comentarios

El sistema solo es capaz de calcular BatteryFullLifeTime basado en cálculos en BatteryLifeTime yBatteryLifePercent. Sin subsistemas de batería inteligente, este valor puede no ser lo suficientemente preciso como para ser útil.

Requisitos

   
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado winbase.h (incluya Windows.h)

Consulte también

GetSystemPowerStatus

PBT_APMPOWERSTATUSCHANGE

ahorro de batería (en las directrices del componente de hardware)