BATTERY_STATUS struttura

Contiene lo stato corrente della batteria. Questa struttura viene usata dal codice di controllo IOCTL_BATTERY_QUERY_STATUS .

Sintassi

typedef struct _BATTERY_STATUS {
  ULONG PowerState;
  ULONG Capacity;
  ULONG Voltage;
  LONG  Rate;
} BATTERY_STATUS, *PBATTERY_STATUS;

Members

PowerState

Stato della batteria. Questo membro può essere zero, uno o più dei valori seguenti.

Valore	Significato
BATTERY_CHARGING 0x00000004	Indica che la batteria è attualmente in carica.
BATTERY_CRITICAL 0x00000008	Indica che l'errore della batteria è imminente. Per altre informazioni, vedere la sezione Osservazioni.
BATTERY_DISCHARGING 0x00000002	Indica che la batteria sta attualmente scaricando.
BATTERY_POWER_ON_LINE 0x00000001	Indica che il sistema ha accesso all'alimentazione AC, quindi non vengono scaricate batterie.

Capacity

Capacità corrente della batteria, in mWh (o relativa). Questo valore può essere usato per generare una visualizzazione "misuratore gas" suddividendola in base al membro FullChargedCapacity della struttura BATTERY_INFORMATION . Se la capacità non è disponibile, questo membro è BATTERY_UNKNOWN_CAPACITY.

Tensione

Tensione corrente della batteria tra i terminali della batteria, in millivolts (mv). Se la tensione non è disponibile, questo membro è BATTERY_UNKNOWN_VOLTAGE.

Frequenza di campionamento

Frequenza corrente di carica o scaricamento della batteria. Questo valore sarà in milliwatts a meno che le informazioni sulla frequenza della batteria non siano relative, nel qual caso sarà in unità arbitrarie all'ora. Per determinare se le informazioni sulla batteria sono relative, esaminare il flag BATTERY_CAPACITY_RELATIVE nel membro Funzionalità della struttura BATTERY_INFORMATION . Un tasso diverso da zero, positivo indica l'addebito; un tasso negativo indica la scaricamento. Alcune batterie segnalano solo i tassi di scaricamento. Se la frequenza non è disponibile, questo membro è BATTERY_UNKNOWN_RATE. Se lo stato della batteria o della fonte di alimentazione cambia, la frequenza potrebbe diventare disponibile.

Commenti

Il flag BATTERY_CRITICAL nel membro PowerState di questa struttura indica una condizione hardware "battery critical". Questo livello critico è impostato dal produttore della batteria, non dall'utente nella "allarme della batteria critica". In genere significa che il sistema della batteria ha calcolato che la batteria è completamente scaricata e qualsiasi alimentazione disegnata è oltre ciò che si prevede.

Requisiti

Vedi anche

BATTERY_INFORMATION

IOCTL_BATTERY_QUERY_STATUS