estrutura BATTERY_STATUS
Contém o estado atual da bateria. Essa estrutura é usada pelo código de controle IOCTL_BATTERY_QUERY_STATUS .
Sintaxe
typedef struct _BATTERY_STATUS {
ULONG PowerState;
ULONG Capacity;
ULONG Voltage;
LONG Rate;
} BATTERY_STATUS, *PBATTERY_STATUS;
Membros
-
PowerState
-
O estado da bateria. Esse membro pode ser zero, um ou mais dos valores a seguir.
Valor Significado - BATTERY_CHARGING
- 0x00000004
Indica que a bateria está sendo carregada no momento. - BATTERY_CRITICAL
- 0x00000008
Indica que a falha da bateria é iminente. Consulte a seção Comentários para obter mais informações. - BATTERY_DISCHARGING
- 0x00000002
Indica que a bateria está sendo descarregada no momento. - BATTERY_POWER_ON_LINE
- 0x00000001
Indica que o sistema tem acesso à energia AC, portanto, nenhuma bateria está sendo descarregada. -
Capacidade
-
A capacidade atual da bateria, em mWh (ou relativa). Esse valor pode ser usado para gerar uma exibição de "medidor de gás" dividindo-a por membro FullChargedCapacity da estrutura BATTERY_INFORMATION . Se a capacidade não estiver disponível, esse membro será BATTERY_UNKNOWN_CAPACITY.
-
Voltagem
-
A tensão da bateria atual entre os terminais de bateria, em mililitros (mv). Se a tensão não estiver disponível, esse membro será BATTERY_UNKNOWN_VOLTAGE.
-
Tarifa
-
A taxa atual de carga ou descarga da bateria. Esse valor estará em miliwatts, a menos que as informações de taxa de bateria sejam relativas, nesse caso, estarão em unidades arbitrárias por hora. Para determinar se as informações da bateria são relativas, examine o sinalizador BATTERY_CAPACITY_RELATIVE no membro Recursos da estrutura BATTERY_INFORMATION . Uma taxa positiva diferente de zero indica a cobrança; uma taxa negativa indica a descarregação. Algumas baterias relatam apenas taxas de descarregamento. Se a taxa não estiver disponível, esse membro será BATTERY_UNKNOWN_RATE. Se o estado da bateria ou fonte de alimentação for alterado, a taxa poderá ficar disponível.
Comentários
O sinalizador BATTERY_CRITICAL no membro do PowerState dessa estrutura indica uma condição de hardware "crítica à bateria". Esse nível crítico é definido pelo fabricante da bateria, não pelo usuário no "alarme crítico da bateria". Isso geralmente significa que o sistema de baterias calculou que a bateria está totalmente drenada, e qualquer energia sendo extraída está além do esperado.
Requisitos
| Requisito | Valor |
|---|---|
| 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 |
|