estrutura SYSTEM_POWER_STATUS (winbase.h)

  • Artigo

Contém informações sobre o status de energia do sistema.

Sintaxe

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

Membros

ACLineStatus

O status de energia ac. Esse membro pode ser um dos valores a seguir.

Valor Significado
0
 Offline
1
 Online
255
 Status Desconhecido

BatteryFlag

A carga da bateria status. Esse membro pode conter um ou mais dos sinalizadores a seguir.

Valor Significado
1
 Alta – a capacidade da bateria está em mais de 66%
2
 Baixa – a capacidade da bateria é inferior a 33%
4
 Crítico – a capacidade da bateria está em menos de 5%
8
 Carregamento
128
 Sem bateria do sistema
255
 Status desconhecido – não é possível ler as informações do sinalizador de bateria
 

O valor será zero se a bateria não estiver sendo carregada e a capacidade da bateria estiver entre baixa e alta.

BatteryLifePercent

O percentual de carga total da bateria restante. Esse membro poderá ser um valor no intervalo de 0 a 100 ou 255 se status for desconhecido.

SystemStatusFlag

O status de economia de bateria. Para participar da conservação de energia, evite tarefas com uso intensivo de recursos quando a economia de bateria estiver ativada. Para ser notificado quando esse valor for alterado, chame a função RegisterPowerSettingNotification com o GUID de configuração de energiaGUID_POWER_SAVING_STATUS.

Valor Significado
0
 A economia de bateria está desativada.
1
 Economia de bateria ativada. Economize energia sempre que possível.
 
Nota Esse sinalizador e o GUID GUID_POWER_SAVING_STATUS foram introduzidos no Windows 10. Esse sinalizador foi reservado anteriormente, chamado Reserved1, e tinha um valor de 0.
 
Para obter informações gerais sobre a economia de bateria, consulte economia de bateria (nas diretrizes de componente de hardware).

BatteryLifeTime

O número de segundos de duração restante da bateria ou –1 se os segundos restantes forem desconhecidos ou se o dispositivo estiver conectado à energia AC.

BatteryFullLifeTime

O número de segundos de duração da bateria quando a carga total ou –1 se o tempo de vida total da bateria for desconhecido ou se o dispositivo estiver conectado à energia AC.

Comentários

O sistema só é capaz de estimar BatteryFullLifeTime com base em cálculos em BatteryLifeTime e BatteryLifePercent. Sem subsistemas de bateria inteligente, esse valor pode não ser preciso o suficiente para ser útil.

Requisitos

   
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho winbase.h (incluir Windows.h)

Confira também

GetSystemPowerStatus

PBT_APMPOWERSTATUSCHANGE

economia de bateria (nas diretrizes do componente de hardware)