Función PowerRegisterForEffectivePowerModeNotifications (powersetting.h)

Registra una devolución de llamada para recibir notificaciones de cambio de modo de energía efectivas.

Sintaxis

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

Parámetros

Version

Proporciona la versión máxima efectiva del modo de alimentación que entiende el autor de la llamada. Si el modo de energía efectivo procede de una versión posterior, se reduce a una versión compatible que luego se pasa a la devolución de llamada.

Se pueden pasar los siguientes valores:

• EFFECTIVE_POWER_MODE_V1 está disponible a partir de Windows 10, versión 1809 y realiza un seguimiento de los estados de ahorro de batería y control deslizante de energía de rendimiento.
• EFFECTIVE_POWER_MODE_V2 está disponible a partir de Windows 10, versión 1903 y realiza un seguimiento del control deslizante de energía de rendimiento, el ahorro de batería, el modo de juego y los estados de energía de windows mixed reality.

Callback

Puntero a la devolución de llamada que se va a llamar cuando cambia el modo de energía efectivo. También se llamará una vez al registro para proporcionar el modo actual. Si se registran varias devoluciones de llamada mediante esta API, esas devoluciones de llamada se pueden llamar simultáneamente.

Context

Contexto opaco especificado por el autor de la llamada.

RegistrationHandle

Identificador del registro. Use este identificador para anular el registro de las notificaciones.

Valor devuelto

Devuelve S_OK (cero) si la llamada se realizó correctamente y un valor distinto de cero si se produjo un error en la llamada.

Comentarios

Inmediatamente después del registro, la devolución de llamada se invocará con el valor actual de la configuración de energía. Si el registro se produce mientras cambia el modo de energía, puede recibir varias devoluciones de llamada; la última devolución de llamada es la actualización más reciente.

Requisitos

Cliente mínimo compatible	Windows 10, versión 1809 [solo aplicaciones de escritorio]
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	powersetting.h
Library	Powrprof.lib
Archivo DLL	Powrprof.dll