WM_POWER消息

通知应用程序系统(通常是电池供电的个人计算机)即将进入挂起模式。

注意

WM_POWER消息已过时。 它仅用于与基于 16 位 Windows 的应用程序兼容。 应用程序应使用 WM_POWERBROADCAST 消息。

窗口通过其 WindowProc 函数接收此消息。

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

参数

hwnd

窗口的句柄。

uMsg

WM_POWER消息标识符。

wParam

电源事件通知。 此参数的取值可为下列值之一:

含义
PWR_CRITICALRESUME
指示系统在进入挂起模式后正在恢复操作,而无需先将 PWR_SUSPENDREQUEST 通知消息广播到应用程序。 应用程序应执行任何必要的恢复操作。
PWR_SUSPENDREQUEST
指示系统即将进入挂起模式。
PWR_SUSPENDRESUME
指示系统在正常进入挂起模式后正在恢复操作,也就是说,系统在系统挂起之前向应用程序广播 PWR_SUSPENDREQUEST 通知消息。 应用程序应执行任何必要的恢复操作。

lParam

未使用此参数。

返回值

应用程序返回的值取决于 wParam 参数的值。 如果 wParam为PWR_SUSPENDREQUEST,则 返回值PWR_FAIL 以防止系统进入挂起状态;否则,它将 PWR_OK。 如果 wParam为PWR_SUSPENDRESUMEPWR_CRITICALRESUME,则返回值为零。

备注

此消息仅广播到在符合高级电源管理 (APM) 基本输入/输出系统 (BIOS) 规范的系统上运行的应用程序。 该消息由电源管理驱动程序广播到 EnumWindows 函数返回的每个窗口。

暂停模式是省电量最大的状态,但保留所有操作数据和参数。 随机访问内存 (RAM) 内容保留,但许多设备可能会关闭。

要求

要求
最低受支持的客户端
Windows XP [仅限桌面应用]
最低受支持的服务器
Windows Server 2003 [仅限桌面应用]
标头
WinUser.h (包括 Windows.h)

请参阅

WM_POWERBROADCAST