Función PowerSettingRegisterNotification (powersetting.h)

  • Artículo

Se registra para recibir notificaciones cuando cambia una configuración de energía.

Sintaxis

DWORD PowerSettingRegisterNotification(
  [in]  LPCGUID       SettingGuid,
  [in]  DWORD         Flags,
  [in]  HANDLE        Recipient,
  [out] PHPOWERNOTIFY RegistrationHandle
);

Parámetros

[in] SettingGuid

GUID que representa la configuración de energía.

[in] Flags

Información sobre el destinatario de la notificación. Este parámetro puede ser uno de los valores siguientes:

Valor Significado
DEVICE_NOTIFY_SERVICE_HANDLE
 El parámetro Recipient es un identificador de un servicio. Use la función CreateService o OpenService para obtener este identificador.
DEVICE_NOTIFY_CALLBACK
 El parámetro Recipient es un puntero a una función de devolución de llamada a la que llamar cuando cambia la configuración de energía. Se espera que el destinatario en este caso sea de tipo PDEVICE_NOTIFY_SUBSCRIBE_PARAMETERS.

[in] Recipient

Identificador para el destinatario de las notificaciones.

[out] RegistrationHandle

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

Valor devuelto

Devuelve ERROR_SUCCESS (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 la configuración de energía, puede recibir varias devoluciones de llamada; la última devolución de llamada es la actualización más reciente.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado powersetting.h
Library Powrprof.lib
Archivo DLL Powrprof.dll

Consulte también

GUID de configuración de energía

PowerSettingUnregisterNotification