PoRegisterForEffectivePowerModeNotifications-Funktion (wdm.h)

Die Funktion PoRegisterForEffectivePowerModeNotifications registriert einen Rückruf, um effektive Benachrichtigungen zum Ändern des Energiemodus zu erhalten.

Syntax

NTSTATUS PoRegisterForEffectivePowerModeNotifications(
  ULONG                             Version,
  PPO_EFFECTIVE_POWER_MODE_CALLBACK Callback,
  PVOID                             Context,
  PO_EPM_HANDLE                     *RegistrationHandle,
  PDEVICE_OBJECT                    DeviceObject
);

Parameter

Version

Stellt die Version des maximalen effektiven Energiemodus bereit, die der Aufrufer versteht. Wenn der effektive Energiemodus aus einer späteren Version stammt, wird er einer kompatiblen Version zugeordnet, 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 den Leistungsregler und die Energiesparzustände nach.

• EFFECTIVE_POWER_MODE_V2 ist ab Windows 10, Version 1903 verfügbar und verfolgt den Leistungsregler, den Akkusparmodus, 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 registriert werden, können diese Rückrufe gleichzeitig aufgerufen werden.

Context

Vom Aufrufer angegebenen undurchsichtigen Kontext.

RegistrationHandle

Dies ist ein Zeiger auf eine Variable, die ein Handle auf die Registrierung empfängt. Dieses Handle kann verwendet werden, um die Registrierung der Rückruffunktion aufzuheben.

DeviceObject

Dies ist ein optionaler Parameter, der, falls angegeben, einen registrierten Rückruf (z. B. von einem Treiber) mit dem angegebenen Gerätekontext bereitstellt.

Rückgabewert

Gibt S_OK (null) zurück, wenn der Aufruf erfolgreich war, und einen Wert ohne Zero, 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

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 11, Version 24H2
Kopfzeile	wdm.h (einschließen von Wdm.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL

Weitere Informationen

PO_EFFECTIVE_POWER_MODE

PO_EFFECTIVE_POWER_MODE_CALLBACK

PoUnregisterFromEffectivePowerModeNotifications