struktur BATTERY_STATUS

Artikel
06/12/2023

Berisi status baterai saat ini. Struktur ini digunakan oleh kode kontrol IOCTL_BATTERY_QUERY_STATUS .

Sintaks

typedef struct _BATTERY_STATUS {
  ULONG PowerState;
  ULONG Capacity;
  ULONG Voltage;
  LONG  Rate;
} BATTERY_STATUS, *PBATTERY_STATUS;

Anggota

PowerState

Keadaan baterai. Anggota ini bisa nol, satu, atau beberapa nilai berikut.

Nilai	Makna
BATTERY_CHARGING 0x00000004	Menunjukkan bahwa baterai sedang diisi dayanya.
BATTERY_CRITICAL 0x00000008	Menunjukkan bahwa kegagalan baterai akan segera terjadi. Lihat bagian Keterangan untuk informasi selengkapnya.
BATTERY_DISCHARGING 0x00000002	Menunjukkan bahwa baterai saat ini sedang dibuang.
BATTERY_POWER_ON_LINE 0x00000001	Menunjukkan bahwa sistem memiliki akses ke daya AC, sehingga tidak ada baterai yang dibuang.

Kapasitas

Kapasitas baterai saat ini, dalam mWh (atau relatif). Nilai ini dapat digunakan untuk menghasilkan tampilan "pengukur gas" dengan membaginya dengan anggota FullChargedCapacity dari struktur BATTERY_INFORMATION . Jika kapasitas tidak tersedia, anggota ini BATTERY_UNKNOWN_CAPACITY.

Voltage

Tegangan baterai saat ini melintasi terminal baterai, dalam milivolt (mv). Jika tegangan tidak tersedia, anggota ini BATTERY_UNKNOWN_VOLTAGE.

Tarif

Laju pengisian daya baterai atau pelepasan saat ini. Nilai ini akan berada dalam miliwatt kecuali informasi laju baterai relatif, dalam hal ini akan berada dalam unit arbitrer per jam. Untuk menentukan apakah informasi baterai relatif, periksa bendera BATTERY_CAPACITY_RELATIVE di anggota Kemampuan struktur BATTERY_INFORMATION . Laju positif nonzero menunjukkan pengisian daya; tingkat negatif menunjukkan pemakaian. Beberapa baterai hanya melaporkan laju pengisian daya. Jika tarif tidak tersedia, anggota ini BATTERY_UNKNOWN_RATE. Jika status baterai atau sumber daya berubah, laju mungkin tersedia.

Keterangan

Bendera BATTERY_CRITICAL di anggota PowerState struktur ini menunjukkan kondisi "baterai kritis" perangkat keras. Tingkat kritis ini diatur oleh produsen baterai, bukan oleh pengguna di "alarm baterai kritis." Ini umumnya berarti bahwa sistem baterai telah menghitung bahwa baterai benar-benar terkuras, dan daya apa pun yang ditarik berada di luar apa yang diharapkan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	Poclass.h; Batclass.h pada Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP

Lihat juga

BATTERY_INFORMATION
IOCTL_BATTERY_QUERY_STATUS

Bagikan melalui