struktur BATTERY_QUERY_INFORMATION

Berisi informasi kueri baterai. Struktur ini digunakan dengan kode kontrol IOCTL_BATTERY_QUERY_INFORMATION untuk menentukan jenis informasi yang akan dikembalikan.

Sintaks

typedef struct _BATTERY_QUERY_INFORMATION {
  ULONG                           BatteryTag;
  BATTERY_QUERY_INFORMATION_LEVEL InformationLevel;
  LONG                            AtRate;
} BATTERY_QUERY_INFORMATION, *PBATTERY_QUERY_INFORMATION;

Anggota

BatteryTag

Tag baterai saat ini untuk baterai. Hanya informasi untuk baterai yang cocok dengan tag yang dapat dikembalikan. Setiap kali nilai ini tidak cocok dengan tag baterai saat ini, permintaan IOCTL akan diselesaikan dengan ERROR_FILE_NOT_FOUND. Ini menunjukkan kepada penelepon bahwa baterai yang terkait dengan tag lebih lama ada. Penelepon dapat memilih untuk menggunakan operasi IOCTL_BATTERY_QUERY_TAG untuk menentukan tag baterai yang baru dipasang, jika ada. (Lihat Tag Baterai untuk informasi selengkapnya.)

Saat permintaan informasi kueri dibuat, nilai ini diverifikasi. Selain itu, jika permintaan sedang berlangsung saat nilai ini berubah, permintaan dibatalkan dengan status ERROR_FILE_NOT_FOUND.

InformationLevel

Tingkat informasi baterai yang sedang dikueri. Data yang dikembalikan oleh IOCTL bergantung pada nilai ini. Anggota ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
BatteryDeviceName 4	Untai (karakter) Unicode null-terminated yang berisi nama baterai.
BatteryEstimatedTime 3	ULONG yang menentukan perkiraan durasi baterai, dalam detik. Jika tingkat pengurasan yang disediakan dalam anggota AtRate dari struktur BATTERY_QUERY_INFORMATION adalah nol, perhitungan ini didasarkan pada tingkat pengurasan saat ini. Jika AtRate bukan nol, waktu yang dikembalikan adalah durasi yang diharapkan untuk tingkat yang diberikan. Jika perkiraan waktu tidak diketahui (misalnya, baterai tidak dibuang dan AtRate yang ditentukan adalah nol), nilai yang dikembalikan BATTERY_UNKNOWN_TIME. Perhatikan bahwa nilai ini tidak terlalu akurat pada beberapa sistem baterai, dan dapat sangat bervariasi tergantung pada penggunaan daya saat ini, yang dapat dipengaruhi oleh aktivitas disk dan faktor lainnya. Tidak ada mekanisme pemberitahuan untuk perubahan nilai ini.
BatteryGranularityInformation 1	Array struktur BATTERY_REPORTING_SCALE , tidak pernah lebih dari empat entri.
Informasi Baterai 0	Struktur BATTERY_INFORMATION .
BatteryManufactureDate 5	Struktur BATTERY_MANUFACTURE_DATE .
BatteryManufactureName 6	Untai (karakter) Unicode yang dihentikan null yang menentukan nama produsen baterai.
BatterySerialNumber 8	String Unicode null-dihentikan yang menentukan nomor seri baterai.
BatteryTemperature 2	ULONG yang menentukan suhu baterai saat ini, dalam 10 derajat Kelvin.
BatteryUniqueID 7	Untai (karakter) Unicode yang dihentikan null yang secara unik mengidentifikasi baterai. Nilai ini dapat digunakan untuk melacak baterai tertentu. Dalam kasus baterai pintar, ID ini akan menjadi perangkaian nama produsen, nama perangkat, tanggal pembuatan, dan representasi nomor seri yang dapat dicetak. Nilai ini tidak dimaksudkan untuk ditampilkan kepada pengguna.

AtRate

Anggota ini hanya digunakan jika InformationLevel adalah BatteryEstimatedTime.

Jika anggota ini bukan nol, itu adalah laju pengosongan yang akan digunakan untuk menghitung waktu sampai baterai dibuang untuk BatteryEstimatedTime dari baterai individu. Ini harus ditentukan dalam mW, dan harus menjadi nilai negatif untuk mewakili laju pengosongan baterai.

Keterangan

Beberapa informasi tentang baterai bersifat opsional atau mungkin tidak berarti untuk beberapa baterai. Jika jenis data tertentu yang diminta tidak tersedia untuk baterai saat ini, maka ERROR_INVALID_FUNCTION dikembalikan.

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

BATTERY_MANUFACTURE_DATE

BATTERY_REPORTING_SCALE

IOCTL_BATTERY_QUERY_INFORMATION

IOCTL_BATTERY_QUERY_TAG