struktur BATTERY_SET_INFORMATION

Berisi informasi baterai yang akan disetel. Struktur ini digunakan dengan kode kontrol IOCTL_BATTERY_SET_INFORMATION .

Sintaks

typedef struct _BATTERY_SET_INFORMATION {
  ULONG                         BatteryTag;
  BATTERY_SET_INFORMATION_LEVEL InformationLevel;
  UCHAR                         Buffer[1];
} BATTERY_SET_INFORMATION, *PBATTERY_SET_INFORMATION;

Anggota

BatteryTag

Tag baterai saat ini untuk baterai. Informasi untuk baterai yang cocok dengan tag hanya dapat dikembalikan. Setiap kali nilai ini tidak cocok dengan tag baterai saat ini, permintaan IOCTL akan diselesaikan dengan ERROR_FILE_NOT_FOUND, yang menunjukkan kepada pemanggil bahwa baterai yang memiliki tag untuk tidak ada lagi. 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

Informasi baterai yang akan diatur. Jenis data dalam anggota Buffer tergantung pada nilai anggota ini. Anggota ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
Pengisian Daya Baterai 1	Menginformasikan perangkat baterai yang telah diminta pengguna bahwa baterai harus diisi daya saat ini. Misalnya, dengan baterai pintar/pengisi daya/pemilih, aplikasi dapat mengisi daya satu baterai pada satu waktu. Anggota Buffer struktur ini diabaikan.
BatteryCriticalBias 0	Mengatur penyesuaian bias kritis baterai. Perhatikan bahwa nilai ini biasanya akan diubah oleh perangkat lunak, dan hadir di antarmuka hanya sebagai fitur pemeliharaan. Tidak semua baterai dapat mempertahankan pengaturan seperti itu, dan informasi baterai harus dibaca untuk mengonfirmasi bahwa baterai menerima pengaturan.
BatteryDischarge 2	Menginformasikan perangkat baterai yang telah diminta pengguna agar baterai dibuang saat ini. Misalnya, ini dapat digunakan untuk menunjukkan baterai mana yang saat ini ingin dijalankan oleh pengguna. Anggota Buffer struktur ini diabaikan.

Buffer

Informasi baterai yang akan diatur. Data tergantung pada nilai InformationLevel.

Keterangan

Struktur BATTERY_SET_INFORMATION adalah struktur panjang variabel, dan Anda harus mengalokasikan buffer dengan ukuran yang sesuai agar informasi disertakan dalam struktur.

Persyaratan

Lihat juga

IOCTL_BATTERY_SET_INFORMATION