Condividi tramite


BATTERY_INFORMATION struttura

Contiene informazioni sulla batteria. Questa struttura viene restituita dal codice di controllo IOCTL_BATTERY_QUERY_INFORMATION quando viene richiesto il livello di informazioni BatteryInformation.

Sintassi

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;

Members

Capabilities

Funzionalità della batteria. Questo membro può essere uno o più dei valori seguenti.

Valore Significato
BATTERY_CAPACITY_RELATIVE
0x40000000
Indica che le informazioni sulla capacità e la frequenza della batteria sono relative e non in unità specifiche. Se questo bit non è impostato, le unità di report sono milliwatt-hours (mWh) per capacità e milliwatts (mW) per la frequenza. Se questo bit è impostato, tutti i riferimenti alle unità nell'altra documentazione della batteria possono essere ignorati. Tutte le informazioni sulla frequenza vengono segnalate in unità all'ora. Ad esempio, se la capacità completamente carica viene segnalata come 100, una frequenza di 200 indica che la batteria userà tutta la sua capacità in mezz'ora.
BATTERY_IS_SHORT_TERM
0x20000000
Indica che la normale operazione è per una funzione non riuscita. Se questo bit non è impostato, la batteria deve essere usata durante l'utilizzo normale del sistema.
BATTERY_SET_CHARGE_SUPPORTED
0x00000001
Indica che le richieste di informazioni impostate del tipo BatteryCharge sono supportate da questo dispositivo della batteria.
BATTERY_SET_DISCHARGE_SUPPORTED
0x00000002
Indica che le richieste di informazioni impostate del tipo BatteryDischarge sono supportate da questo dispositivo della batteria.
BATTERY_SYSTEM_BATTERY
0x80000000
Indica che la batteria può fornire potenza generale per eseguire il sistema.

Tecnologia

La tecnologia della batteria. Questo membro può essere uno dei valori seguenti.

Valore Significato
0
Batteria non caricabile, ad esempio, alcalina.
1
Batteria ricaricabile, ad esempio, acido di piombo.

Reserved

Riservato.

Chimica

Stringa di caratteri abbreviata che indica la chimica della batteria. Questa stringa non è necessariamente senza terminazione. Di seguito è riportato un elenco parziale di abbreviazioni che possono essere restituite e le chimiche associate.

Stringa Unicode Significato
PbAc
Piombo
LEONE
Ioni di litio
Li-I
Ioni di litio
Nicd
NickelRidium
Nimh
Idride del metallo di nickel
Nizn
Zinco di nickel
RAM
Alkaline-Manganese ricaricabili

Altri chimici possono essere visualizzati in futuro e il codice dovrebbe essere in grado di gestirli.

DesignCapacity

Capacità teorica della batteria quando nuova, in mWh a meno che non sia impostata BATTERY_CAPACITY_RELATIVE. In tal caso, le unità non sono definito.

FullChargedCapacity

La capacità corrente della batteria è completamente carica in mWh (o relativa). Confrontare questo valore con DesignedCapacity per stimare l'usura della batteria.

DefaultAlert1

La capacità suggerita dal produttore, in mWh, in cui deve verificarsi un avviso a batteria bassa. Le definizioni di basso variare dal produttore al produttore. In generale, uno stato di avviso si verificherà prima di uno stato basso, ma non è consigliabile presupponerlo sempre. Per ridurre il rischio di perdita di dati, questo valore viene in genere usato come impostazione predefinita per l'allarme della batteria critica.

DefaultAlert2

Capacità suggerita dal produttore, in mWh, in cui deve verificarsi un avviso della batteria di avviso. Le definizioni di avviso variano da produttore a produttore. In generale, uno stato di avviso si verificherà prima di uno stato basso, ma non è consigliabile presupponerlo sempre. Per ridurre il rischio di perdita di dati, questo valore viene in genere usato come impostazione predefinita per l'allarme a batteria bassa.

CriticalBias

Un pregiudizio da zero, in mWh, che viene applicato alla segnalazione della batteria. Alcune batterie riservano una piccola carica che è compromessa dai valori di capacità della batteria per mostrare "0" come livello di batteria critico. Il pregiudizio critico è analogo all'impostazione di un misuratore di carburante per mostrare "vuoto" quando ci sono diversi litri di carburante lasciato.

CycleCount

Il numero di cicli di carica/scaricamento della batteria ha riscontrato. Ciò fornisce un mezzo per determinare l'usura della batteria. Se la batteria non supporta un contatore del ciclo, questo membro è zero.

Commenti

In genere, uno stato di avviso si verifica prima di uno stato basso, ma non è consigliabile presupponerlo. È possibile eseguire il polling di una batteria e trovare che nessuno dei due livelli di avviso si è verificato di nuovo e il polling della batteria e trovarlo scaricato nella misura in cui sono stati raggiunti entrambi i livelli. Ciò può indicare che non si esegue il polling abbastanza spesso. Può anche indicare che la batteria non è in grado di contenere una carica per molto tempo e sta scaricando più rapidamente di quanto previsto. Tale batteria può essere vicino alla fine della sua vita utile, o può essere danneggiato.

Requisiti

Requisito Valore
Client minimo supportato
Windows XP [solo app desktop]
Server minimo supportato
Windows Server 2003 [solo app desktop]
Intestazione
Poclass.h;
Batclass.h in Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP

Vedi anche

IOCTL_BATTERY_QUERY_INFORMATION