struktur BATTERY_INFORMATION

Artikel
06/12/2023

Berisi informasi baterai. Struktur ini dikembalikan oleh kode kontrol IOCTL_BATTERY_QUERY_INFORMATION ketika tingkat informasi BatteryInformation diminta.

Sintaks

typedef struct _BATTERY_INFORMATION {
  ULONG Capabilities;
  UCHAR Technology;
  UCHAR Reserved[3];
  UCHAR Chemistry[4];
  ULONG DesignedCapacity;
  ULONG FullChargedCapacity;
  ULONG DefaultAlert1;
  ULONG DefaultAlert2;
  ULONG CriticalBias;
  ULONG CycleCount;
} BATTERY_INFORMATION, *PBATTERY_INFORMATION;

Anggota

Kemampuan

Kemampuan baterai. Anggota ini bisa menjadi satu atau beberapa nilai berikut.

Nilai	Makna
BATTERY_CAPACITY_RELATIVE 0x40000000	Menunjukkan bahwa kapasitas baterai dan informasi tarif relatif, dan tidak dalam unit tertentu. Jika bit ini tidak ditetapkan, unit pelaporan adalah miliwatt-jam (mWh) untuk kapasitas dan miliwatt (mW) untuk tarif. Jika bit ini diatur, semua referensi ke unit dalam dokumentasi baterai lainnya dapat diabaikan. Semua informasi tarif dilaporkan dalam satuan per jam. Misalnya, jika kapasitas terisi penuh dilaporkan sebagai 100, laju 200 menunjukkan bahwa baterai akan menggunakan semua kapasitasnya dalam setengah jam.
BATTERY_IS_SHORT_TERM 0x20000000	Menunjukkan bahwa operasi normal adalah untuk fungsi yang gagal aman. Jika bit ini tidak diatur, baterai diperkirakan akan digunakan selama penggunaan sistem normal.
BATTERY_SET_CHARGE_SUPPORTED 0x00000001	Menunjukkan bahwa permintaan informasi yang diatur dari jenis BatteryCharge didukung oleh perangkat baterai ini.
BATTERY_SET_DISCHARGE_SUPPORTED 0x00000002	Menunjukkan bahwa permintaan informasi yang diatur dari jenis BatteryDischarge didukung oleh perangkat baterai ini.
BATTERY_SYSTEM_BATTERY 0x80000000	Menunjukkan bahwa baterai dapat memberikan daya umum untuk menjalankan sistem.

Teknologi

Teknologi baterai. Anggota ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
0	Baterai yang tidak dapat diisi ulang, misalnya, alkali.
1	Baterai yang dapat diisi ulang, misalnya, asam timbal.

Dipesan

Dicadangkan.

Kimia

String karakter singkatan yang menunjukkan kimia baterai. String ini belum tentu dihentikan nol. Berikut ini adalah daftar sebagian singkatan yang dapat dikembalikan dan kimia terkait.

String Unicode	Makna
PbAc	Asam Timbal
LION	Lithium Ion
Li-I	Lithium Ion
NiCd	Nikel Cadmium
Nimh	Nikel Logam Hydride
NiZn	Seng Nikel
RAM	Alkaline-Manganese yang dapat diisi ulang

Kimia lain mungkin muncul di masa depan dan kode Anda harus dapat menanganinya.

DesignedCapacity

Kapasitas teoritis baterai ketika baru, dalam mWh kecuali BATTERY_CAPACITY_RELATIVE diatur. Dalam hal ini, unit tidak terdefinisi.

FullChargedCapacity

Kapasitas baterai yang terisi penuh saat ini dalam mWh (atau relatif). Bandingkan nilai ini dengan DesignCapacity untuk memperkirakan keausan baterai.

DefaultAlert1

Kapasitas yang disarankan produsen, 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

Kapasitas yang disarankan produsen, 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.

CriticalBias

Bias dari nol, dalam mWh, yang diterapkan pada pelaporan baterai. Beberapa baterai memesan muatan kecil yang bias dari nilai kapasitas baterai untuk menunjukkan "0" sebagai tingkat baterai kritis. Bias kritis dianalogikan dengan mengatur pengukur bahan bakar untuk menunjukkan "kosong" ketika ada beberapa liter bahan bakar yang tersisa.

CycleCount

Jumlah siklus pengisian daya/pengisian daya yang dialami baterai. Ini menyediakan sarana untuk menentukan keausan baterai. Jika baterai tidak mendukung penghitung siklus, anggota ini adalah nol.

Keterangan

Umumnya, status peringatan terjadi sebelum status rendah, tetapi Anda tidak boleh menganggapnya akan terjadi. Dimungkinkan untuk melakukan polling baterai dan menemukan bahwa tidak ada tingkat peringatan yang terjadi, dan polling baterai lagi dan menemukannya habis sejauh kedua tingkat telah dicapai. Ini mungkin menunjukkan bahwa Anda tidak cukup sering melakukan polling. Ini mungkin juga menunjukkan bahwa baterai tidak dapat menahan daya untuk waktu yang sangat lama dan mengeluarkan lebih cepat dari yang Anda harapkan. Baterai seperti itu mungkin mendekati akhir masa pakainya yang berguna, atau mungkin rusak.

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

IOCTL_BATTERY_QUERY_INFORMATION

Bagikan melalui