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