Funzione PowerRegisterForEffectivePowerModeNotifications (powersetting.h)

Articolo
08/25/2023

Registra un callback per ricevere notifiche di modifica effettive della modalità di alimentazione.

Sintassi

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

Parametri

Version

Fornisce la versione massima effettiva della modalità di alimentazione che il chiamante capisce. Se la modalità di alimentazione effettiva proviene da una versione successiva, viene ridotta a una versione compatibile che viene quindi passata al callback.

I valori seguenti possono essere passati:

EFFECTIVE_POWER_MODE_V1 è disponibile a partire da Windows 10, versione 1809 e tiene traccia degli stati di risparmio energia delle prestazioni e risparmio batteria.
EFFECTIVE_POWER_MODE_V2 è disponibile a partire da Windows 10, versione 1903 e tiene traccia del dispositivo di scorrimento delle prestazioni, risparmio batteria, modalità gioco e stati di potenza di realtà mista windows.

Callback

Puntatore al callback da chiamare quando cambia la modalità di alimentazione effettiva. Verrà chiamato anche una volta alla registrazione per fornire la modalità corrente. Se più callback vengono registrati usando questa API, tali callback possono essere chiamati simultaneamente.

Context

Contesto opaco specificato dal chiamante.

RegistrationHandle

Handle per la registrazione. Usare questo handle per annullare la registrazione per le notifiche.

Valore restituito

Restituisce S_OK (zero) se la chiamata ha esito positivo e un valore diverso da zero se la chiamata non è riuscita.

Commenti

Immediatamente dopo la registrazione, il callback verrà richiamato con il valore corrente dell'impostazione di alimentazione. Se la registrazione si verifica durante la modifica della modalità di alimentazione, è possibile ricevere più callback; l'ultimo callback è l'aggiornamento più recente.

Requisiti


Client minimo supportato	Windows 10, versione 1809 [solo app desktop]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	powersetting.h
Libreria	Powrprof.lib
DLL	Powrprof.dll

Condividi tramite