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 |