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
-
power-event 通知。 このパラメーターには、次の値のいずれかを指定できます。
値 説明 - PWR_CRITICALRESUME
最初に PWR_SUSPENDREQUEST通知メッセージ をアプリケーションにブロードキャストせずに、中断モードに入った後にシステムが操作を再開することを示します。 アプリケーションは、必要な回復アクションを実行する必要があります。 - PWR_SUSPENDREQUEST
システムが中断モードに入りようとしていることを示します。 - PWR_SUSPENDRESUME
システムが通常は中断モードに入った後に操作を再開していることを示します。つまり、システムは、システムが中断される前に 、PWR_SUSPENDREQUEST 通知メッセージをアプリケーションにブロードキャストします。 アプリケーションは、必要な回復アクションを実行する必要があります。 -
lParam
-
このパラメーターは使用されません。
アプリケーションが返す値は、 wParam パラメーターの値によって異なります。 wParam がPWR_SUSPENDREQUEST場合、システムが中断状態にならないように戻り値がPWR_FAILされます。それ以外の場合は、PWR_OK。 wParam がPWR_SUSPENDRESUMEまたはPWR_CRITICALRESUMEの場合、戻り値は 0 になります。
このメッセージは、Advanced Power Management (APM) の基本的な入出力システム (BIOS) 仕様に準拠しているシステムで実行されているアプリケーションにのみブロードキャストされます。 このメッセージは、電源管理ドライバーによって 、EnumWindows 関数によって返される各ウィンドウにブロードキャストされます。
中断モードは、最大の電力節約が発生した状態ですが、すべての運用データとパラメーターが保持されます。 ランダム アクセス メモリ (RAM) の内容は保持されますが、多くのデバイスがオフになる可能性があります。
要件 | 値 |
---|---|
サポートされている最小のクライアント |
Windows XP [デスクトップ アプリのみ] |
サポートされている最小のサーバー |
Windows Server 2003 [デスクトップ アプリのみ] |
Header |
|