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_SUSPENDRESUME 或 PWR_CRITICALRESUME,则返回值为零。
备注
此消息仅广播到在符合高级电源管理 (APM) 基本输入/输出系统 (BIOS) 规范的系统上运行的应用程序。 该消息由电源管理驱动程序广播到 EnumWindows 函数返回的每个窗口。
暂停模式是省电量最大的状态,但保留所有操作数据和参数。 随机访问内存 (RAM) 内容保留,但许多设备可能会关闭。
要求
要求 | 值 |
---|---|
最低受支持的客户端 |
Windows XP [仅限桌面应用] |
最低受支持的服务器 |
Windows Server 2003 [仅限桌面应用] |
标头 |
|