PowerSetRequest

電源要求オブジェクトに対する指定種別の電源要求の数を増やす。

PowerSetRequest PowerRequest, RequestType

PowerRequest : [intptr] 電源要求オブジェクトのハンドル。
RequestType : [int] 

(プラグイン / モジュール : kernel32.dll)

解説

電源要求オブジェクトに対する指定種別の電源要求の数を増やす。

[戻り値]
関数が成功した場合、0 以外の値を返す。関数が失敗した場合、0 を返す。拡張エラー情報を取得するには GetLastError を呼ぶ。

[備考]
DC 電源で動作するモダンスタンバイシステムでは、システムスリープタイムアウト経過後 5 分で、system required および
execution required の電源要求は終了する。従来型スリープ (S3) システム上の
PowerRequestAwayModeRequired
を除き、電源要求はユーザー起動のシステムスリープ開始時（電源ボタン、蓋を閉じる、またはスタートメニューから **スリープ**
を選ぶ）に終了する。電力を節約し最良のユーザー体験を提供するため、電源要求を使うアプリケーションは次のベストプラクティスに従うべきである:
* 電源要求を作成する際、REASON_CONTEXT 構造体に要求理由を説明するローカライズされたテキスト文字列を指定する。*
要求を必要とするシナリオの直前に PowerSetRequest を呼ぶ。* シナリオが終了したらすぐに
PowerClearRequest を呼んで要求の参照カウントを減らす。*
プロセスが終了したりサービスが停止したりする前に、すべての要求オブジェクトと関連ハンドルをクリーンアップする。

情報