IOCTL_BATTERY_SET_INFORMATION kode kontrol
Mengatur berbagai informasi baterai. Struktur parameter input, BATTERY_SET_INFORMATION, menunjukkan informasi status baterai mana yang akan diatur.
Untuk melakukan operasi ini, panggil fungsi DeviceIoControl dengan parameter berikut.
BOOL DeviceIoControl(
(HANDLE) hDevice, // handle to battery
IOCTL_BATTERY_SET_INFORMATION, // dwIoControlCode
(LPVOID) lpInBuffer, // input buffer
(DWORD) nInBufferSize, // size of input buffer
NULL, // lpOutBuffer
0, // nOutBufferSize
(LPDWORD) lpBytesReturned, // number of bytes returned
(LPOVERLAPPED) lpOverlapped // OVERLAPPED structure
);
Parameter
-
hDevice
-
Handel ke baterai tempat informasi akan diatur. Untuk mengambil handel perangkat, panggil fungsi CreateFile .
-
dwIoControlCode
-
Kode kontrol untuk operasi. Nilai ini mengidentifikasi operasi tertentu yang akan dilakukan dan jenis perangkat untuk melakukannya. Gunakan IOCTL_BATTERY_SET_INFORMATION untuk operasi ini.
-
lpInBuffer
-
Penunjuk ke struktur BATTERY_SET_INFORMATION .
-
nInBufferSize
-
Ukuran buffer input, dalam byte.
-
lpOutBuffer
-
Tidak digunakan dengan operasi ini; atur ke NULL.
-
nOutBufferSize
-
Tidak digunakan dengan operasi ini; atur ke nol.
-
lpBytesReturned
-
Penunjuk ke variabel yang menerima ukuran data yang dikembalikan dalam buffer lpOutBuffer , dalam byte.
Jika buffer output terlalu kecil untuk mengembalikan data apa pun, maka panggilan gagal, GetLastError mengembalikan kode kesalahan ERROR_INSUFFICIENT_BUFFER, dan jumlah byte yang dikembalikan adalah nol.
Jika lpOverlapped adalah NULL (tidak tumpang tindih I/O), lpBytesReturned tidak boleh NULL, bahkan jika lpOutBuffer adalah NULL.
Jika lpOverlapped bukan NULL (Tumpang tindih I/O), lpBytesReturned bisa NULL. Jika ini adalah operasi yang tumpang tindih, Anda dapat mengambil jumlah byte yang dikembalikan dengan memanggil fungsi GetOverlappedResult . Jika hDevice dikaitkan dengan port penyelesaian I/O, Anda bisa mendapatkan jumlah byte yang dikembalikan dengan memanggil fungsi GetQueuedCompletionStatus .
-
lpOverlapped
-
Penunjuk ke struktur yang TUMPANG TINDIH .
Jika hDevice dibuka dengan bendera FILE_FLAG_OVERLAPPED, lpOverlapped harus menunjuk ke struktur TUMPANG TINDIH yang valid. Dalam hal ini, DeviceIoControl dilakukan sebagai operasi yang tumpang tindih (asinkron). Jika perangkat dibuka dengan bendera FILE_FLAG_OVERLAPPED dan lpOverlapped adalah NULL, fungsi gagal dengan cara yang tidak dapat diprediksi.
Jika hDevice dibuka tanpa menentukan bendera FILE_FLAG_OVERLAPPED, lpOverlapped diabaikan dan fungsi DeviceIoControl tidak kembali sampai operasi selesai, atau sampai terjadi kesalahan.
Nilai kembali
Jika operasi berhasil diselesaikan, DeviceIoControl mengembalikan nilai bukan nol.
Jika operasi gagal atau tertunda, DeviceIoControl mengembalikan nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
Semua permintaan informasi baterai akan selesai dengan status ERROR_NO_SUCH_DEVICE (atau ERROR_FILE_NOT_FOUND di Windows 10 versi 1809 dan yang lebih lama) setiap kali elemen BatteryTag permintaan tidak cocok dengan tag baterai saat ini. Ini memastikan bahwa informasi baterai yang dikembalikan cocok dengan baterai yang diminta (lihat Tag Baterai untuk informasi selengkapnya).
Keterangan
Semua permintaan untuk mengatur informasi baterai akan selesai dengan status ERROR_FILE_NOT_FOUND jika tag baterai permintaan tidak cocok dengan tag baterai saat ini.
Untuk implikasi I/O yang tumpang tindih pada operasi ini, lihat bagian Keterangan dari topik DeviceIoControl .
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung |
Windows XP [hanya aplikasi desktop] |
| Server minimum yang didukung |
Windows Server 2003 [hanya aplikasi desktop] |
| Header |
|