struktur SYSTEM_POWER_STATUS (winbase.h)

Artikel
03/08/2023

Berisi informasi tentang status daya sistem.

Sintaks

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

Anggota

ACLineStatus

Status daya AC. Anggota ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
0	Offline
1	Online
255	Status tidak diketahui

BatteryFlag

Status pengisian daya baterai. Anggota ini bisa berisi satu atau beberapa bendera berikut.

Nilai	Makna
1	Tinggi—kapasitas baterai lebih dari 66 persen
2	Rendah—kapasitas baterai kurang dari 33 persen
4	Penting—kapasitas baterai kurang dari lima persen
8	Pengisian
128	Tidak ada baterai sistem
255	Status tidak diketahui—tidak dapat membaca informasi bendera baterai

Nilainya adalah nol jika baterai tidak diisi dayanya dan kapasitas baterai antara rendah dan tinggi.

BatteryLifePercent

Persentase sisa pengisian baterai penuh. Anggota ini bisa menjadi nilai dalam rentang 0 hingga 100, atau 255 jika status tidak diketahui.

SystemStatusFlag

Status penghemat baterai. Untuk berpartisipasi dalam konservasi energi, hindari tugas intensif sumber daya saat penghemat baterai aktif. Untuk diberi tahu ketika nilai ini berubah, panggil fungsi RegisterPowerSettingNotification dengan pengaturan daya GUID, GUID_POWER_SAVING_STATUS.

Nilai	Makna
0	Penghemat baterai mati.
1	Penghemat baterai aktif. Hemat energi jika memungkinkan.

Catatan Bendera ini dan GUID GUID_POWER_SAVING_STATUS diperkenalkan dalam Windows 10. Bendera ini sebelumnya dicadangkan, bernama Reserved1, dan memiliki nilai 0.

Untuk informasi umum tentang penghemat baterai, lihat penghemat baterai (dalam pedoman komponen perangkat keras).

BatteryLifeTime

Jumlah detik sisa masa pakai baterai, atau –1 jika sisa detik tidak diketahui atau jika perangkat tersambung ke daya AC.

BatteryFullLifeTime

Jumlah detik masa pakai baterai saat diisi penuh, atau –1 jika masa pakai baterai penuh tidak diketahui atau jika perangkat tersambung ke daya AC.

Keterangan

Sistem ini hanya mampu memperkirakan BatteryFullLifeTime berdasarkan perhitungan pada BatteryLifeTime dan BatteryLifePercent. Tanpa subsistem baterai pintar, nilai ini mungkin tidak cukup akurat untuk berguna.

Persyaratan


Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	winbase.h (termasuk Windows.h)

Lihat juga

GetSystemPowerStatus

PBT_APMPOWERSTATUSCHANGE

penghemat baterai (dalam pedoman komponen perangkat keras)

Bagikan melalui