PowerRegisterForEffectivePowerModeNotifications 関数 (powersetting.h)

有効な電源モード変更通知を受け取るコールバックを登録します。

構文

HRESULT PowerRegisterForEffectivePowerModeNotifications(
  ULONG                         Version,
  EFFECTIVE_POWER_MODE_CALLBACK *Callback,
  PVOID                         Context,
  PVOID                         *RegistrationHandle
);

パラメーター

Version

呼び出し元が認識する最大有効電力モード バージョンを提供します。 有効な電源モードが新しいバージョンから取得された場合は、互換性のあるバージョンに縮小され、その後コールバックに渡されます。

次の値を渡すことができます。

• EFFECTIVE_POWER_MODE_V1は、Windows 10 Version 1809以降で使用でき、パフォーマンスの電源スライダーとバッテリー節約の状態を追跡します。
• EFFECTIVE_POWER_MODE_V2は、Windows 10 バージョン 1903 以降で使用でき、パフォーマンス電源スライダー、バッテリー セーバー、ゲーム モード、Windows Mixed Reality の電源状態を追跡します。

Callback

有効な電源モードが変更されたときに呼び出すコールバックへのポインター。 これは、登録時に 1 回呼び出され、現在のモードが提供されます。 この API を使用して複数のコールバックが登録されている場合は、それらのコールバックを同時に呼び出すことができます。

Context

呼び出し元指定の不透明なコンテキスト。

RegistrationHandle

登録のハンドル。 このハンドルを使用して、通知の登録を解除します。

戻り値

呼び出しが成功した場合はS_OK (0) を返し、呼び出しが失敗した場合は 0 以外の値を返します。

解説

登録直後に、電源設定の現在の値を使用してコールバックが呼び出されます。 電源モードの変更中に登録が発生した場合は、複数のコールバックを受け取る可能性があります。最後のコールバックは最新の更新です。

要件