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