PoSetPowerRequest 関数 (wdm.h)
PoSetPowerRequest ルーチンは、指定した電源要求の種類の数をインクリメントします。
構文
NTSTATUS PoSetPowerRequest(
[in, out] PVOID PowerRequest,
[in] POWER_REQUEST_TYPE Type
);
パラメーター
[in, out] PowerRequest
PoCreatePowerRequest ルーチンによって作成された電源要求オブジェクトへのポインター。
[in] Type
電源要求の種類。 このパラメーターを次のPOWER_REQUEST_TYPE列挙値 に 設定します。
- PowerRequestSystemRequired
戻り値
呼び出しが成功した場合、PoSetPowerRequest はSTATUS_SUCCESSを返します。 呼び出しが失敗した場合、次のようなエラー リターン コードが返されます。
| リターン コード | 説明 |
|---|---|
|
Type パラメーターは、サポートされていない値に設定されています。 |
注釈
ドライバーは PoSetPowerRequest ルーチンを呼び出して、 電源マネージャー がいくつかの種類の既定の電源動作をオーバーライドするように要求できます。これは、列挙値 POWER_REQUEST_TYPE 指定されます。 既定の動作を復元するために、ドライバーは PoClearPowerRequest ルーチンを呼び出して要求を取り消します。
電源マネージャーは、電源要求の種類ごとにアクティブな要求の数を保持します。 PoSetPowerRequest ルーチンは、指定した電源要求の種類の数を 1 ずつインクリメントします。 PoClearPowerRequest ルーチンは、カウントを 1 ずつデクリメントします。 0 以外の数は、1 つ以上のコンポーネントからの要求がアクティブであることを示します。 カウントが 0 に減った後、コンピューターは指定した電源要求の種類の既定の動作に戻ります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 7 以降で使用できます。 |
| 対象プラットフォーム | ユニバーサル |
| Header | wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む) |
| Library | NtosKrnl.lib |
| [DLL] | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |