Fungsi GetDevicePowerState (winbase.h)
Mengambil status daya perangkat yang ditentukan saat ini. Fungsi ini tidak dapat digunakan untuk mengkueri status daya perangkat tampilan.
Sintaks
BOOL GetDevicePowerState(
[in] HANDLE hDevice,
[out] BOOL *pfOn
);
Parameter
[in] hDevice
Handel ke objek pada perangkat, seperti file atau soket, atau handel ke perangkat itu sendiri.
[out] pfOn
Penunjuk ke variabel yang menerima status daya. Nilai ini TRUE jika perangkat dalam status berfungsi. Jika tidak, itu adalah FALSE.
Menampilkan nilai
Jika fungsi berhasil, nilai yang dikembalikan bukan nol.
Jika fungsi gagal, nilai yang dikembalikan adalah nol.
Keterangan
Aplikasi dapat menggunakan GetDevicePowerState untuk menentukan apakah perangkat dalam status berfungsi atau status berdaya rendah. Jika perangkat dalam keadaan berdaya rendah, mengakses perangkat dapat menyebabkannya mengantre atau mengalihkan permintaan I/O apa pun, atau mengubah perangkat ke status kerja. Perilaku yang tepat tergantung pada implementasi perangkat.
Untuk memastikan masa pakai baterai maksimum pada komputer laptop, gunakan GetDevicePowerState untuk mengurangi konsumsi daya. Misalnya, jika disk saat ini dimatikan, mengakses disk akan menyebabkannya berputar, yang mengakibatkan peningkatan konsumsi daya dan mengurangi masa pakai baterai.
Aplikasi harus menangguhkan atau membatasi akses ke perangkat sedapat mungkin saat sistem berjalan pada daya baterai. Untuk menentukan apakah sistem berjalan dengan daya baterai, dan sisa masa pakai baterai, gunakan fungsi GetSystemPowerStatus .
Persyaratan
Klien minimum yang didukung | Windows XP [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | winbase.h (termasuk Windows.h) |
Pustaka | Kernel32.lib |
DLL | Kernel32.dll |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk