Fonction de rappel PEPCALLBACKNOTIFYDPM (pepfx.h)

  • Article

Une routine de rappel d’événement AcceptDeviceNotification 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 retournée

La routine AcceptDeviceNotification 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 du 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 leurs types de structure associés, consultez Notifications de gestion de l’alimentation des appareils (DPM).

Les notifications DPM informent le pep de divers événements au niveau du système, de l’appareil ou du composant, ou passent des demandes du pilote de périphérique au PEP.

La routine AcceptDeviceNotification n’a pas besoin d’accepter toutes les demandes 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 celles-ci. Le PEP doit refuser de gérer (en retournant FALSE) chaque notification qu’il ne reconnaît pas.

La routine AcceptDeviceNotification peut être appelée dans IRQL <= DISPATCH_LEVEL. L’IRQL auquel la routine AcceptAcpiNotification du PEP est appelée varie en fonction du type de notification envoyée. 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).

Configuration requise

Condition requise Valeur
Client minimal pris en charge Pris en charge à partir de Windows 10.
Plateforme cible Windows
En-tête pepfx.h (include Pep_x.h)
IRQL <= DISPATCH_LEVEL

Voir aussi

PEP_INFORMATION

PoFxRegisterPlugin

PoFxRegisterPluginEx