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

注釈

ドライバーは PoSetPowerRequest ルーチンを呼び出して、 電源マネージャー がいくつかの種類の既定の電源動作をオーバーライドするように要求できます。これは、列挙値 POWER_REQUEST_TYPE 指定されます。 既定の動作を復元するために、ドライバーは PoClearPowerRequest ルーチンを呼び出して要求を取り消します。

電源マネージャーは、電源要求の種類ごとにアクティブな要求の数を保持します。 PoSetPowerRequest ルーチンは、指定した電源要求の種類の数を 1 ずつインクリメントします。 PoClearPowerRequest ルーチンは、カウントを 1 ずつデクリメントします。 0 以外の数は、1 つ以上のコンポーネントからの要求がアクティブであることを示します。 カウントが 0 に減った後、コンピューターは指定した電源要求の種類の既定の動作に戻ります。

要件

こちらもご覧ください

POWER_REQUEST_TYPE

PoClearPowerRequest

PoCreatePowerRequest