estrutura SYSTEM_BATTERY_STATE (winnt.h)

Contém informações sobre o estado atual da bateria do sistema.

Sintaxe

typedef struct {
  BOOLEAN AcOnLine;
  BOOLEAN BatteryPresent;
  BOOLEAN Charging;
  BOOLEAN Discharging;
  BOOLEAN Spare1[3];
  BYTE    Tag;
  DWORD   MaxCapacity;
  DWORD   RemainingCapacity;
  DWORD   Rate;
  DWORD   EstimatedTime;
  DWORD   DefaultAlert1;
  DWORD   DefaultAlert2;
} SYSTEM_BATTERY_STATE, *PSYSTEM_BATTERY_STATE;

Membros

AcOnLine

Se esse membro for TRUE, o carregador de bateria do sistema está operando com energia externa no momento.

BatteryPresent

Se esse membro for TRUE, pelo menos uma bateria estará presente no sistema.

Charging

Se esse membro for TRUE, uma bateria será carregada no momento.

Discharging

Se esse membro for TRUE, uma bateria será descarregada no momento.

Spare1[3]

Reservado.

Tag

MaxCapacity

A capacidade teórica da bateria quando nova.

RemainingCapacity

A capacidade restante estimada da bateria.

Rate

A taxa atual de descarga da bateria, em mW. Uma taxa positiva diferente de zero indica o carregamento; uma taxa negativa indica a descarregação. Algumas baterias relatam apenas taxas de descarregamento. Esse valor deve ser tratado como LONG, pois pode conter valores negativos (com o conjunto de bits alto).

EstimatedTime

O tempo estimado restante na bateria, em segundos.

DefaultAlert1

A sugestão do fabricante de uma capacidade, em mWh, na qual um alerta de bateria baixa deve ocorrer. As definições de baixa variam de fabricante para fabricante. Em geral, um estado de aviso ocorrerá antes de um estado baixo, mas você não deve assumir que ele sempre ocorrerá. Para reduzir o risco de perda de dados, esse valor geralmente é usado como a configuração padrão para o alarme crítico da bateria.

DefaultAlert2

A sugestão do fabricante de uma capacidade, em mWh, na qual deve ocorrer um alerta de bateria de aviso. As definições de aviso variam de fabricante para fabricante. Em geral, um estado de aviso ocorrerá antes de um estado baixo, mas você não deve assumir que ele sempre ocorrerá. Para reduzir o risco de perda de dados, esse valor geralmente é usado como a configuração padrão para o alarme de bateria baixa.

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	winnt.h (inclua Windows.h)

Confira também

CallNtPowerInformation