Condividi tramite


struttura SYSTEM_POWER_STATUS (winbase.h)

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)