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

Vedi anche

PEP_INFORMATION

PoFxRegisterPlugin

PoFxRegisterPluginEx