PEPCALLBACKNOTIFYDPM, fonction de rappel (pepfx.h)
Un AcceptDeviceNotification routine de rappel d’événements gère les notifications de gestion de l’alimentation des appareils (DPM) à partir de l’infrastructure de gestion de l’alimentation Windows (PoFx).
Syntaxe
PEPCALLBACKNOTIFYDPM Pepcallbacknotifydpm;
BOOLEAN Pepcallbacknotifydpm(
[in] ULONG Notification,
[in, out, optional] PVOID Data
)
{...}
Paramètres
[in] Notification
ID de notification DPM. Ce paramètre spécifie le type de notification DPM que PoFx envoie. Pour obtenir la liste des ID de notification DPM, consultez notifications de gestion de l’alimentation des appareils (DPM).
[in, out, optional] Data
Pointeur vers une structure allouée par PoFx qui contient les données d’entrée et/ou de sortie pour cette notification. Le type de cette structure dépend de l’ID de notification spécifié par Notification. Pour obtenir la liste des types de structure définis pour les différents ID de notification DPM, consultez notifications de gestion de l’alimentation des appareils (DPM).
Valeur de retour
L'AcceptDeviceNotification routine doit retourner TRUE si elle gère la notification, ou FALSE si ce n’est pas le cas.
Remarques
Cette routine est implémentée par le plug-in d’extension de plateforme (PEP) pour un appareil. Le membre AcceptDeviceNotification de la structure PEP_INFORMATION est un pointeur vers une routine AcceptDeviceNotification. Le PEP appelle la routine PoFxRegisterPlugin ou PoFxRegisterPluginEx pour inscrire la routine AcceptDeviceNotification pep auprès de PoFx.
PoFx appelle cette routine pour envoyer une notification DPM au pep. Dans cet appel, le paramètre Notification spécifie le type de notification, et le paramètre Data pointe vers une structure de données du type associé à cette notification. Pour obtenir la liste des ID de notification DPM et de leurs types de structure associés, consultez notifications de gestion de l’alimentation des appareils (DPM).
Les notifications DPM informent le pep sur différents événements au niveau du système, de l’appareil ou du composant, ou transmettent les demandes du pilote de périphérique au pep.
La routine AcceptDeviceNotification n’a pas besoin d’accepter chaque demande du pilote de périphérique, par exemple, elle peut ignorer les indicateurs de résidence inactifs. Toutefois, le PEP doit comprendre et accepter la plupart des notifications de gestion de l’alimentation des appareils, même si le PEP choisit de ne pas agir sur eux. Le PEP doit refuser de gérer (en retournant FALSE) chaque notification qu’elle ne reconnaît pas.
La routine AcceptDeviceNotification peut être appelée à l'<IRQL = DISPATCH_LEVEL. Le runtime d’intégration (IRQL) auquel la routine AcceptAcpiNotification du PEP est appelée varie en fonction du type de notification envoyé. Le type de notification est spécifié par le paramètre notification. Pour plus d’informations, consultez les pages de référence individuelles sous notifications de gestion de l’alimentation des appareils (DPM).
Exigences
Exigence | Valeur |
---|---|
client minimum pris en charge | Prise en charge à partir de Windows 10. |
plateforme cible | Windows |
d’en-tête | pepfx.h (include Pep_x.h) |
IRQL | <= DISPATCH_LEVEL |