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) |