struttura SYSTEM_BATTERY_STATE (winnt.h)

Contiene informazioni sullo stato corrente della batteria del sistema.

Sintassi

typedef struct {
  BOOLEAN AcOnLine;
  BOOLEAN BatteryPresent;
  BOOLEAN Charging;
  BOOLEAN Discharging;
  BOOLEAN Spare1[3];
  BYTE    Tag;
  DWORD   MaxCapacity;
  DWORD   RemainingCapacity;
  DWORD   Rate;
  DWORD   EstimatedTime;
  DWORD   DefaultAlert1;
  DWORD   DefaultAlert2;
} SYSTEM_BATTERY_STATE, *PSYSTEM_BATTERY_STATE;

Members

AcOnLine

Se questo membro è TRUE, il caricatore della batteria di sistema sta attualmente operando sull'alimentazione esterna.

BatteryPresent

Se questo membro è TRUE, nel sistema è presente almeno una batteria.

Charging

Se questo membro è TRUE, una batteria è attualmente carica.

Discharging

Se questo membro è TRUE, una batteria sta attualmente scaricando.

Spare1[3]

Riservato.

Tag

MaxCapacity

La capacità teorica della batteria quando è nuova.

RemainingCapacity

Capacità rimanente stimata della batteria.

Rate

La frequenza corrente di scaricamento della batteria, in mW. Un tasso diverso da zero, positivo indica l'addebito; un tasso negativo indica la scaricamento. Alcune batterie segnalano solo i tassi di scarico. Questo valore deve essere considerato long perché può contenere valori negativi (con il set di bit elevato).

EstimatedTime

Tempo stimato rimanente sulla batteria, espresso in secondi.

DefaultAlert1

Il suggerimento del produttore di una capacità, in mWh, in cui dovrebbe verificarsi un avviso a batteria bassa. Le definizioni di basso variano da produttore a produttore. In generale, si verificherà uno stato di avviso prima di uno stato basso, ma non è consigliabile presupporre che sempre. Per ridurre il rischio di perdita di dati, questo valore viene in genere usato come impostazione predefinita per l'allarme critico della batteria.

DefaultAlert2

Il suggerimento del produttore di una capacità, in mWh, in cui deve verificarsi un avviso della batteria di avviso. Le definizioni di avviso variano da produttore a produttore. In generale, si verificherà uno stato di avviso prima di uno stato basso, ma non è consigliabile presupporre che sempre. Per ridurre il rischio di perdita di dati, questo valore viene in genere usato come impostazione predefinita per l'allarme a batteria insufficiente.

Requisiti

Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	winnt.h (include Windows.h)

Vedi anche

CallNtPowerInformation