estrutura BATTERY_INFORMATION
Contém informações de bateria. Essa estrutura é retornada pelo código de controle IOCTL_BATTERY_QUERY_INFORMATION quando o nível de informações BatteryInformation é solicitado.
Sintaxe
typedef struct _BATTERY_INFORMATION {
ULONG Capabilities;
UCHAR Technology;
UCHAR Reserved[3];
UCHAR Chemistry[4];
ULONG DesignedCapacity;
ULONG FullChargedCapacity;
ULONG DefaultAlert1;
ULONG DefaultAlert2;
ULONG CriticalBias;
ULONG CycleCount;
} BATTERY_INFORMATION, *PBATTERY_INFORMATION;
Membros
-
Funcionalidades
-
As funcionalidades da bateria. Esse membro pode ser um ou mais dos valores a seguir.
Valor Significado - BATTERY_CAPACITY_RELATIVE
- 0x40000000
Indica que as informações de capacidade e taxa da bateria são relativas e não em unidades específicas. Se esse bit não estiver definido, as unidades de relatório serão miliwatts-hora (mWh) para capacidade e miliwatts (mW) para taxa. Se esse bit for definido, todas as referências a unidades na outra documentação da bateria poderão ser ignoradas. Todas as informações de taxa são relatadas em unidades por hora. Por exemplo, se a capacidade totalmente carregada for relatada como 100, uma taxa de 200 indica que a bateria usará toda a sua capacidade em meia hora. - BATTERY_IS_SHORT_TERM
- 0x20000000
Indica que a operação normal é para uma função à prova de falhas. Se esse bit não estiver definido, espera-se que a bateria seja usada durante o uso normal do sistema. - BATTERY_SET_CHARGE_SUPPORTED
- 0x00000001
Indica que as solicitações de informações definidas do tipo BatteryCharge são compatíveis com este dispositivo de bateria. - BATTERY_SET_DISCHARGE_SUPPORTED
- 0x00000002
Indica que as solicitações de informações definidas do tipo BatteryDischarge são compatíveis com este dispositivo de bateria. - BATTERY_SYSTEM_BATTERY
- 0x80000000
Indica que a bateria pode fornecer energia geral para executar o sistema. -
Tecnologia
-
A tecnologia da bateria. Esse membro pode ser um dos valores a seguir.
Valor Significado - 0
Bateria não recargável, por exemplo, alcalina. - 1
Bateria recarregável, por exemplo, ácido de chumbo. -
Reserved
-
Reservado.
-
Química
-
Uma cadeia de caracteres abreviada que indica a química da bateria. Essa cadeia de caracteres não é necessariamente terminada em zero. Veja a seguir uma lista parcial de abreviações que podem ser retornadas e as químicas associadas.
Cadeia de caracteres Unicode Significado - PbAc
Ácido de chumbo - LEÃO
Íon de lítio - Li-I
Íon de lítio - Nicd
Níquel Cadmium - Nimh
Hydride de Metal de Níquel - Nizn
Zinco de níquel - RAM
Alkaline-Manganese recarregáveis Outras químicas podem aparecer no futuro e seu código deve ser capaz de lidar com elas.
-
DesignedCapacity
-
A capacidade teórica da bateria quando nova, em mWh, a menos que BATTERY_CAPACITY_RELATIVE esteja definida. Nesse caso, as unidades são indefinidas.
-
FullChargedCapacity
-
A capacidade atual totalmente carregada da bateria em mWh (ou relativa). Compare esse valor com DesignedCapacity para estimar o desgaste da bateria.
-
DefaultAlert1
-
A capacidade sugerida do fabricante, 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 capacidade sugerida pelo fabricante, 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.
-
CriticalBias
-
Um desvio de zero, em mWh, que é aplicado ao relatório de bateria. Algumas baterias reservam uma pequena carga que é tendenciosa dos valores de capacidade da bateria para mostrar "0" como o nível crítico da bateria. O viés crítico é análogo à configuração de um medidor de combustível para mostrar "vazio" quando há vários litros de combustível restantes.
-
CycleCount
-
O número de ciclos de carga/descarga que a bateria experimentou. Isso fornece um meio de determinar o desgaste da bateria. Se a bateria não der suporte a um contador de ciclo, esse membro será zero.
Comentários
Em geral, um estado de aviso ocorre antes de um estado baixo, mas você não deve presumir que ocorrerá. É possível sondar uma bateria e descobrir que nenhum nível de alerta ocorreu, sondar a bateria novamente e encontrá-la descarregada na medida em que ambos os níveis foram alcançados. Isso pode indicar que você não está sondando com frequência suficiente. Também pode indicar que a bateria não consegue segurar uma carga por muito tempo e está descarregando mais rapidamente do que você esperava. Tal bateria pode estar se aproximando do fim de sua vida útil, ou pode estar danificada.
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 |
|