struktur SYSTEM_BATTERY_STATE (winnt.h)

  • Artikel

Berisi informasi tentang status baterai sistem saat ini.

Sintaks

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;

Anggota

AcOnLine

Jika anggota ini TRUE, pengisi daya baterai sistem saat ini beroperasi pada daya eksternal.

BatteryPresent

Jika anggota ini TRUE, setidaknya satu baterai ada dalam sistem.

Charging

Jika anggota ini TRUE, baterai saat ini sedang diisi dayanya.

Discharging

Jika anggota ini TRUE, baterai saat ini sedang dibuang.

Spare1[3]

Dicadangkan.

Tag

MaxCapacity

Kapasitas teoritis baterai saat baru.

RemainingCapacity

Perkiraan kapasitas baterai yang tersisa.

Rate

Laju pengosongan baterai saat ini, dalam mW. Laju positif nonzero menunjukkan pengisian daya; tingkat negatif menunjukkan pemakaian. Beberapa baterai hanya melaporkan laju pengisian daya. Nilai ini harus diperlakukan sebagai LONG karena dapat berisi nilai negatif (dengan set bit tinggi).

EstimatedTime

Perkiraan waktu yang tersisa pada baterai, dalam hitung detik.

DefaultAlert1

Saran produsen tentang kapasitas, dalam mWh, di mana peringatan baterai rendah harus terjadi. Definisi rendah bervariasi dari produsen ke produsen. Secara umum, status peringatan akan terjadi sebelum status rendah, tetapi Anda tidak boleh berasumsi bahwa itu akan selalu terjadi. Untuk mengurangi risiko kehilangan data, nilai ini biasanya digunakan sebagai pengaturan default untuk alarm baterai penting.

DefaultAlert2

Saran produsen tentang kapasitas, dalam mWh, di mana peringatan baterai peringatan harus terjadi. Definisi peringatan bervariasi dari produsen ke produsen. Secara umum, status peringatan akan terjadi sebelum status rendah, tetapi Anda tidak boleh berasumsi bahwa itu akan selalu terjadi. Untuk mengurangi risiko kehilangan data, nilai ini biasanya digunakan sebagai pengaturan default untuk alarm baterai rendah.

Persyaratan

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

Lihat juga

CallNtPowerInformation