PowerRegisterForEffectivePowerModeNotifications-Funktion (powersetting.h)

  • Artikel

Registriert einen Rückruf, um effektive Benachrichtigungen zum Ändern des Energiemodus zu erhalten.

Syntax

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

Parameter

Version

Stellt die Version des maximalen effektiven Leistungsmodus bereit, die der Aufrufer versteht. Wenn der effektive Energiemodus aus einer späteren Version stammt, wird er auf eine kompatible Version reduziert, die dann an den Rückruf übergeben wird.

Die folgenden Werte können übergeben werden:

  • EFFECTIVE_POWER_MODE_V1 ist ab Windows 10, Version 1809 verfügbar und verfolgt die Leistungsregler- und Stromsparmoduszustände nach.
  • EFFECTIVE_POWER_MODE_V2 ist ab Windows 10, Version 1903 verfügbar und verfolgt den Leistungsregler, den Stromsparmodus, den Spielmodus und die Windows Mixed Reality-Energiezustände nach.

Callback

Ein Zeiger auf den Rückruf, der aufgerufen werden soll, wenn sich der effektive Energiemodus ändert. Dies wird auch einmal bei der Registrierung aufgerufen, um den aktuellen Modus anzugeben. Wenn mehrere Rückrufe mit dieser API registriert werden, können diese Rückrufe gleichzeitig aufgerufen werden.

Context

Vom Aufrufer angegebener undurchsichtiger Kontext.

RegistrationHandle

Ein Handle für die Registrierung. Verwenden Sie dieses Handle, um die Registrierung für Benachrichtigungen aufzuheben.

Rückgabewert

Gibt S_OK (null) zurück, wenn der Aufruf erfolgreich war, und einen Wert ungleich null, wenn der Aufruf fehlgeschlagen ist.

Hinweise

Unmittelbar nach der Registrierung wird der Rückruf mit dem aktuellen Wert der Energieeinstellung aufgerufen. Wenn die Registrierung erfolgt, während sich der Energiemodus ändert, erhalten Sie möglicherweise mehrere Rückrufe. der letzte Rückruf ist das neueste Update.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 10, Version 1809 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Nicht unterstützt
Zielplattform Windows
Kopfzeile powersetting.h
Bibliothek Powrprof.lib
DLL Powrprof.dll