WM_POWER pesan

Memberi tahu aplikasi bahwa sistem, biasanya komputer pribadi bertenaga baterai, akan memasuki mode ditangguhkan.

Catatan

Pesan WM_POWER usang. Ini disediakan hanya untuk kompatibilitas dengan aplikasi berbasis Windows 16-bit. Aplikasi harus menggunakan pesan WM_POWERBROADCAST .

Jendela menerima pesan ini melalui fungsi WindowProc-nya .

LRESULT CALLBACK WindowProc
  HWND   hwnd,    // handle to window
  UINT   uMsg,    // WM_POWER
  WPARAM wParam,  // power-event notification
  LPARAM lParam   // not used
); 

Parameter

hwnd

Handel ke jendela.

uMsg

Pengidentifikasi pesan WM_POWER .

wParam

Pemberitahuan power-event. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai Makna
PWR_CRITICALRESUME
Menunjukkan bahwa sistem melanjutkan operasi setelah memasuki mode ditangguhkan tanpa terlebih dahulu menyiarkan pesan pemberitahuan PWR_SUSPENDREQUEST ke aplikasi. Aplikasi harus melakukan tindakan pemulihan yang diperlukan.
PWR_SUSPENDREQUEST
Menunjukkan bahwa sistem akan memasuki mode ditangguhkan.
PWR_SUSPENDRESUME
Menunjukkan bahwa sistem melanjutkan operasi setelah memasuki mode ditangguhkan biasanya yaitu, sistem menyiarkan pesan pemberitahuan PWR_SUSPENDREQUEST ke aplikasi sebelum sistem ditangguhkan. Aplikasi harus melakukan tindakan pemulihan yang diperlukan.

lParam

Parameter ini tidak digunakan.

Nilai kembali

Nilai yang dikembalikan aplikasi tergantung pada nilai parameter wParam . Jika wParamPWR_SUSPENDREQUEST, nilai yang dikembalikan PWR_FAIL untuk mencegah sistem memasuki status ditangguhkan; jika tidak, itu PWR_OK. Jika wParamPWR_SUSPENDRESUME atau PWR_CRITICALRESUME, nilai yang dikembalikan adalah nol.

Keterangan

Pesan ini disiarkan hanya ke aplikasi yang berjalan pada sistem yang sesuai dengan spesifikasi sistem input/output dasar (BIOS) Advanced Power Management (APM). Pesan disiarkan oleh driver manajemen daya ke setiap jendela yang dikembalikan oleh fungsi EnumWindows .

Mode yang ditangguhkan adalah status di mana jumlah penghematan daya terbesar terjadi, tetapi semua data dan parameter operasional dipertahankan. Konten memori akses acak (RAM) dipertahankan, tetapi banyak perangkat kemungkinan akan dimatikan.

Persyaratan

Persyaratan Nilai
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)

Lihat juga

WM_POWERBROADCAST