Funzione PowerSettingRegisterNotification (powersetting.h)

  • Articolo

Registra per ricevere una notifica quando viene modificata un'impostazione di alimentazione.

Sintassi

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

Parametri

[in] SettingGuid

GUID che rappresenta l'impostazione di alimentazione.

[in] Flags

Informazioni sul destinatario della notifica. Questo parametro può essere uno dei valori seguenti:

Valore Significato
DEVICE_NOTIFY_SERVICE_HANDLE
 Il parametro Recipient è un handle per un servizio. Usare la funzione CreateService o OpenService per ottenere questo handle.
DEVICE_NOTIFY_CALLBACK
 Il parametro Recipient è un puntatore a una funzione di callback da chiamare quando l'impostazione di alimentazione cambia. Il destinatario in questo caso deve essere di tipo PDEVICE_NOTIFY_SUBSCRIBE_PARAMETERS.

[in] Recipient

Handle per il destinatario delle notifiche.

[out] RegistrationHandle

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

Valore restituito

Restituisce ERROR_SUCCESS (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 dell'impostazione di alimentazione, è possibile ricevere più callback; l'ultimo callback è l'aggiornamento più recente.

Requisiti

Requisito Valore
Client minimo supportato Windows 7 [solo app desktop]
Server minimo supportato Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione powersetting.h
Libreria Powrprof.lib
DLL Powrprof.dll

Vedi anche

GUID dell'impostazione di alimentazione

PowerSettingUnregisterNotification