Funzione di callback PEPCALLBACKNOTIFYDPM (pepfx.h)
Una routine di callback degli eventi AcceptDeviceNotification gestisce le notifiche di risparmio energia del dispositivo dal framework di risparmio energia di Windows (PoFx).
Sintassi
PEPCALLBACKNOTIFYDPM Pepcallbacknotifydpm;
BOOLEAN Pepcallbacknotifydpm(
[in] ULONG Notification,
[in, out, optional] PVOID Data
)
{...}
Parametri
[in] Notification
ID notifica DPM. Questo parametro specifica il tipo di notifica DPM che PoFx sta inviando. Per un elenco degli ID di notifica DPM, vedere Notifiche di risparmio energia del dispositivo (DPM).
[in, out, optional] Data
Puntatore a una struttura allocata da PoFx che contiene i dati di input e/o output per questa notifica. Il tipo di questa struttura dipende dall'ID di notifica specificato dalla notifica. Per un elenco dei tipi di struttura definiti per i vari ID notifica DPM, vedere Notifiche di DPM (Device Power Management).
Valore restituito
La routine AcceptDeviceNotification deve restituire TRUE se gestisce la notifica o FALSE in caso contrario.
Commenti
Questa routine viene implementata dal plug-in di estensione della piattaforma (PEP) per un dispositivo. Il membro AcceptDeviceNotification della struttura PEP_INFORMATION è un puntatore a una routine AcceptDeviceNotification . Il PEP chiama la routine PoFxRegisterPlugin o PoFxRegisterPluginEx per registrare la routine AcceptDeviceNotification di PEP con PoFx.
PoFx chiama questa routine per inviare una notifica DPM al PEP. In questa chiamata, il parametro Notification specifica il tipo di notifica e il parametro Data punta a una struttura di dati del tipo associato a questa notifica. Per un elenco degli ID notifica DPM e dei relativi tipi di struttura associati, vedere Notifiche di risparmio energia del dispositivo (DPM).
Le notifiche DPM informano il PEP su vari eventi a livello di sistema, dispositivo o componente oppure passano richieste dal driver di dispositivo al PEP.
La routine AcceptDeviceNotification non deve accettare ogni richiesta dal driver di dispositivo, ad esempio può ignorare gli hint di residenza inattiva. Tuttavia, il PEP deve comprendere e accettare la maggior parte delle notifiche di risparmio energia del dispositivo anche se il PEP sceglie di non agire su di essi. Il PEP deve rifiutare di gestire (restituendo FALSE) ogni notifica che non riconosce.
La routine AcceptDeviceNotification può essere chiamata in IRQL <= DISPATCH_LEVEL. L'IRQL in corrispondenza del quale viene chiamata la routine AcceptAcpiNotification del PEP varia in base al tipo di notifica inviato. Il tipo di notifica viene specificato dal parametro Notification . Per altre informazioni, vedere le singole pagine di riferimento in Notifiche di risparmio energia del dispositivo (DPM).
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Supportato a partire da Windows 10. |
| Piattaforma di destinazione | Windows |
| Intestazione | pepfx.h (include Pep_x.h) |
| IRQL | <= DISPATCH_LEVEL |