Funzione PowerSettingRegisterNotification (powersetting.h)
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 |
---|---|
|
Il parametro Recipient è un handle per un servizio. Usare la funzione CreateService o OpenService per ottenere questo handle. |
|
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 |