Funzione di callback PEPCALLBACKNOTIFYDPM (pepfx.h)
Un AcceptDeviceNotification routine di callback degli eventi gestisce le notifiche DPM (Device Power Management) 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 DPM (Device Power Management).
[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 da Notifica. Per un elenco dei tipi di struttura definiti per i vari ID notifica DPM, vedere notifiche DPM (Device Power Management).
Valore restituito
La routine AcceptDeviceNotification deve restituire TRUE se gestisce la notifica o FALSE in caso contrario.
Osservazioni
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 AcceptDeviceNot ification 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 di notifica DPM e dei relativi tipi di struttura associati, vedere notifiche DPM (Device Power Management).
Le notifiche DPM informano il PEP su vari eventi a livello di sistema, dispositivo o componente o 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 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 DPM (Device Power Management).
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Supportato a partire da Windows 10. |
| piattaforma di destinazione | Finestre |
| intestazione | pepfx.h (include Pep_x.h) |
| IRQL | <= DISPATCH_LEVEL |