peristiwa PBT_APMPOWERSTATUSCHANGE

Memberi tahu aplikasi tentang perubahan status daya komputer, seperti sakelar dari daya baterai ke A/C. Sistem juga menyiarkan peristiwa ini ketika sisa daya baterai tergelincir di bawah ambang yang ditentukan oleh pengguna atau jika daya baterai berubah dengan persentase yang ditentukan.

Jendela menerima peristiwa ini melalui pesan WM_POWERBROADCAST. Parameter wParam dan lParam diatur seperti yang dijelaskan berikut.

LRESULT 
CALLBACK 
WindowProc( HWND hwnd,      // handle to window
            UINT uMsg,      // WM_POWERBROADCAST
            WPARAM wParam,  // PBT_APMPOWERSTATUSCHANGE
            LPARAM lParam); // zero

Parameter

hwnd

Handel ke jendela.

uMsg

Value	Makna
WM_POWERBROADCAST 536 (0x218)	Pengidentifikasi pesan.

wParam

Value	Makna
PBT_APMPOWERSTATUSCHANGE 10 (0xA)	Pengidentifikasi peristiwa.

lParam

Dipesan; harus nol.

Nilai hasil

Tidak ada nilai yang ditampilkan.

Keterangan

Aplikasi harus memproses peristiwa ini dengan memanggil fungsi GetSystemPowerStatus untuk mengambil status daya komputer saat ini. Secara khusus, aplikasi harus memeriksa anggota ACLineStatus, BatteryFlag, BatteryLifeTime, dan BatteryLifePercent dari struktur SYSTEM_POWER_STATUS untuk setiap perubahan. Peristiwa ini dapat terjadi ketika masa pakai baterai turun hingga kurang dari 5 menit, atau ketika persentase masa pakai baterai turun di bawah 10 persen, atau jika masa pakai baterai berubah sebesar 3 persen.

Persyaratan

Persyaratan	Value
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	WinUser.h (termasuk Windows.h)

Baca juga

• Status daya sistem
• Peristiwa manajemen daya
• GetSystemPowerStatus
• SYSTEM_POWER_STATUS
• WM_POWERBROADCAST