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を返します。 呼び出しが失敗した場合、次のようなエラー リターン コードが返されます。

リターン コード 説明
STATUS_NOT_SUPPORTED
 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

こちらもご覧ください

POWER_REQUEST_TYPE

PoClearPowerRequest

PoCreatePowerRequest