struttura SYSTEM_POWER_STATUS (winbase.h)

Articolo
03/08/2023

Contiene informazioni sullo stato di alimentazione del sistema.

Sintassi

typedef struct _SYSTEM_POWER_STATUS {
  BYTE  ACLineStatus;
  BYTE  BatteryFlag;
  BYTE  BatteryLifePercent;
  BYTE  SystemStatusFlag;
  DWORD BatteryLifeTime;
  DWORD BatteryFullLifeTime;
} SYSTEM_POWER_STATUS, *LPSYSTEM_POWER_STATUS;

Members

ACLineStatus

Stato di alimentazione AC. Questo membro può essere uno dei valori seguenti.

Valore	Significato
0	Offline
1	Online
255	Stato sconosciuto

BatteryFlag

Stato di carica della batteria. Questo membro può contenere uno o più flag seguenti.

Valore	Significato
1	Alta: la capacità della batteria è superiore al 66%
2	Bassa: la capacità della batteria è inferiore al 33%
4	Critico: la capacità della batteria è inferiore al 5%
8	Carica
128	Nessuna batteria di sistema
255	Stato sconosciuto: non è possibile leggere le informazioni sul flag della batteria

Il valore è zero se la batteria non viene caricata e la capacità della batteria è compresa tra bassa e alta.

BatteryLifePercent

Percentuale di carica completa della batteria rimanente. Questo membro può essere un valore compreso nell'intervallo da 0 a 100 o 255 se lo stato è sconosciuto.

SystemStatusFlag

Stato del risparmio batteria. Per partecipare alla conservazione dell'energia, evitare attività a elevato utilizzo di risorse quando il risparmio batteria è attivo. Per ricevere una notifica quando questo valore cambia, chiamare la funzione RegisterPowerSettingNotification con il GUID dell'impostazione dell'alimentazioneGUID_POWER_SAVING_STATUS.

Valore	Significato
0	Il risparmio batteria è spento.
1	Risparmio batteria acceso. Risparmiare energia laddove possibile.

Nota Questo flag e il GUID GUID_POWER_SAVING_STATUS sono stati introdotti in Windows 10. Questo flag era precedentemente riservato, denominato Reserved1, e aveva un valore pari a 0.

Per informazioni generali sul risparmio batteria, vedere Risparmio batteria (nelle linee guida sui componenti hardware).

BatteryLifeTime

Numero di secondi di durata della batteria rimanenti oppure –1 se i secondi rimanenti sono sconosciuti o se il dispositivo è connesso all'alimentazione AC.

BatteryFullLifeTime

Numero di secondi di durata della batteria quando a carica intera o -1 se la durata completa della batteria è sconosciuta o se il dispositivo è connesso all'alimentazione AC.

Commenti

Il sistema è in grado di stimare BatteryFullLifeTime solo in base ai calcoli su BatteryLifeTime e BatteryLifePercent. Senza sottosistemi di batteria intelligenti, questo valore potrebbe non essere abbastanza accurato da essere utile.

Requisiti


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

Vedi anche

GetSystemPowerStatus

PBT_APMPOWERSTATUSCHANGE

risparmio batteria (nelle linee guida dei componenti hardware)

Share via