PoSetPowerRequest 関数 (ntifs.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
ターゲット プラットフォーム の	万国
ヘッダー	ntifs.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
ライブラリ	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL

関連項目

POWER_REQUEST_TYPE

PoClearPowerRequestの

PoCreatePowerRequestをする