Notifications de gestion de l’alimentation des appareils (DPM)

Chaque notification de gestion de l’alimentation de l’appareil (DPM) que la routine de rappel AcceptDeviceNotification de PEP reçoit est accompagnée d’un paramètre de notification qui indique le type de notification et un paramètre de données qui pointe vers une structure de données qui contient les informations du type de notification spécifié.

Dans cet appel, le paramètre notification est défini sur une valeur constante PEP_DPM_XXX qui indique le type de notification. Le paramètre De données pointe vers un type de structure PEP_XXX associé à ce type de notification.

ID de notification

Les ID de notification DPM suivants sont utilisés par la routine de rappel AcceptDeviceNotification.

PEP_DPM_PREPARE_DEVICE

Notification (PEP_DPM_PREPARE_DEVICE)

La valeur de PEP_DPM_PREPARE_DEVICE.

Données (PEP_DPM_PREPARE_DEVICE)

Pointeur vers une structure PEP_PREPARE_DEVICE . Indique au PEP propriétaire de l’appareil spécifié de configurer l’appareil pour qu’il fonctionne dans l’état d’alimentation de l’appareil D0 (opérationnel).

L’infrastructure de gestion de l’alimentation Windows (PoFx) envoie cette notification au pep avant le démarrage de la pile de pilotes d’un appareil pour la première fois par le système d’exploitation. Cette notification permet au PEP d’activer toutes les ressources d’alimentation ou d’horloge externes requises pour faire fonctionner l’appareil.

Pour envoyer une notification PEP_DPM_PREPARE_DEVICE, le système d’exploitation appelle la routine de rappel AcceptDeviceNotification du PEP. Dans cet appel, la valeur du paramètre de notification est PEP_DPM_PREPARE_DEVICE, et le paramètre Données pointe vers une structure PEP_PREPARE_DEVICE. Lors de l’entrée, le membre DeviceId de cette structure est une chaîne d’identification d’appareil qui identifie de façon unique un appareil. Avant de retourner, le pep définit le membre DeviceAccepted de cette structure sur TRUE pour revendiquer la propriété de l’appareil, ou sur FALSE pour indiquer qu’il ne possède pas l’appareil.

Le PEP en charge de la gestion de l’alimentation d’un appareil est responsable de la gestion des ressources d’alimentation et d'horloge qui sont externes à l’appareil et nécessaires pour faire fonctionner l'appareil. Ce PEP active le signal d’horloge et l’alimentation de l’appareil en réponse à une notification de PEP_DPM_PREPARE_DEVICE, et supprime le signal d’horloge et l’alimentation de l’appareil en réponse à une notification de PEP_DPM_ABANDON_DEVICE.

Le tableau suivant présente les conditions préalables qui sont en vigueur lorsque ce système d’exploitation envoie une notification PEP_DPM_PREPARE_DEVICE au pep et les postconditions qui doivent être appliquées après que le pep gère cette notification pour un appareil qu’il possède.

Aucunes notifications PEP_DPM_PREPARE_DEVICE ne sont envoyées pour les appareils principaux.

Pour une notification PEP_DPM_PREPARE_DEVICE, la routine AcceptDeviceNotification est toujours appelée lorsque IRQL = PASSIVE_LEVEL.

PEP_DPM_ABANDON_DEVICE

Notification (PEP_DPM_ABANDON_DEVICE)

Valeur PEP_DPM_ABANDON_DEVICE.

Données (PEP_DPM_ABANDON_DEVICE)

Pointeur vers une structure PEP_ABANDON_DEVICE . Indique au PEP que le dispositif spécifié n'est plus utilisé par le système d'exploitation.

L’infrastructure de gestion de l’alimentation Windows (PoFx) envoie cette notification au PEP une fois que le système d’exploitation a supprimé la pile de pilotes d’un dispositif. Cette notification permet au PEP de désactiver les ressources d’alimentation ou d’horloge externes utilisées pour utiliser l’appareil et de supprimer cet appareil des processus de prise de décision futurs. Si l’appareil doit être redémarré ultérieurement, le PEP reçoit d’abord une notification de PEP_DPM_PREPARE_DEVICE.

Pour envoyer une notification PEP_DPM_ABANDON_DEVICE, le système d’exploitation appelle la routine de rappel AcceptDeviceNotification du PEP. Dans cet appel, la valeur du paramètre de notification est PEP_DPM_ABANDON_DEVICE, et le paramètre De données pointe vers une structure PEP_ABANDON_DEVICE. Lors de l’entrée, le membre DeviceId de cette structure est une chaîne d’identification d’appareil qui identifie de façon unique un appareil. Avant de retourner, le pep définit le membre DeviceAccepted de cette structure sur TRUE pour revendiquer la propriété de l’appareil, ou sur FALSE pour indiquer qu’il ne possède pas l’appareil.

Le PEP chargé de la gestion de l’alimentation d’un appareil est responsable de la gestion des ressources d'alimentation et d’horloge qui sont externes à l’appareil et qui sont nécessaires à l’exploitation de l’appareil.

Le tableau suivant présente les conditions préalables qui sont en vigueur lorsque ce système d’exploitation envoie une notification PEP_DPM_ABANDON_DEVICE au pep et les postconditions qui doivent être appliquées après que le PEP gère cette notification pour un appareil qu’il possède.

PEP_DPM_REGISTER_DEVICE

Notification (PEP_DPM_REGISTER_DEVICE)

Valeur PEP_DPM_REGISTER_DEVICE.

Données (PEP_DPM_REGISTER_DEVICE)

Pointeur vers une structure PEP_REGISTER_DEVICE_V2 .

Indique au PEP que la pile de pilotes de l'appareil spécifié a été enregistrée auprès du cadre de gestion de l'alimentation Windows (PoFx).

PoFx envoie cette notification lorsque la pile de pilotes de l’appareil appelle la routine PoFxRegisterDevice pour inscrire l’appareil. Cette notification permet au PEP de copier les informations d’inscription de l’appareil dans le stockage interne du PEP pour référence ultérieure.

Pour envoyer une notification PEP_DPM_REGISTER_DEVICE, le système d’exploitation appelle la routine de rappel AcceptDeviceNotification du PEP. Dans cet appel, la valeur du paramètre de notification est PEP_DPM_REGISTER_DEVICE, et le paramètre De données pointe vers une structure PEP_REGISTER_DEVICE_V2 qui contient le handle du noyau de l’appareil et d’autres informations d’inscription. Lors de l’entrée, le membre DeviceId de cette structure est une chaîne d’identification d’appareil qui identifie de façon unique un appareil. Avant de retourner, le pep définit le membre DeviceAccepted de cette structure sur TRUE pour revendiquer la propriété de l’appareil, ou sur FALSE pour indiquer qu’il ne possède pas l’appareil. Pour plus d’informations sur les autres membres de cette structure, consultez PEP_REGISTER_DEVICE_V2.

Le tableau suivant présente les conditions préalables qui sont en vigueur lorsque ce système d’exploitation envoie une notification PEP_DPM_REGISTER_DEVICE au pep et les postconditions qui doivent être appliquées après que le pep gère cette notification pour un appareil qu’il possède.

Pour une notification PEP_DPM_REGISTER_DEVICE, la routine AcceptDeviceNotification est toujours appelée à un niveau IRQL égal à PASSIVE_LEVEL.

PEP_DPM_UNREGISTER_DEVICE

Notification (PEP_DPM_UNREGISTER_DEVICE)

Valeur PEP_DPM_UNREGISTER_DEVICE.

Données (PEP_DPM_UNREGISTER_DEVICE)

Pointeur vers une structure PEP_UNREGISTER_DEVICE .

Indique au PEP propriétaire de l’appareil spécifié que la pile de pilotes de l’appareil a retiré son inscription de l’infrastructure de gestion de l’alimentation Windows (PoFx).

PoFx envoie cette notification pour informer le PEP que toutes les informations d'enregistrement que le PEP a stockées pour l'appareil lors de la notification PEP_DPM_REGISTER_DEVICE précédente ne sont plus valides. En réponse, le PEP peut nettoyer n’importe quel état interne utilisé pour la gestion de l’alimentation de cet appareil.

Pour envoyer une notification PEP_DPM_UNREGISTER_DEVICE, le système d’exploitation appelle la routine de rappel AcceptDeviceNotification du PEP. Dans cet appel, la valeur du paramètre de notification est PEP_DPM_UNREGISTER_DEVICE, et le paramètre De données pointe vers une structure PEP_UNREGISTER_DEVICE. Cette structure contient le handle créé par le PEP en réponse à la notification PEP_DPM_REGISTER_DEVICE précédente pour cet appareil.

Le tableau suivant présente les conditions préalables qui sont en vigueur lorsque ce système d’exploitation envoie une notification PEP_DPM_UNREGISTER_DEVICE au pep et les postconditions qui doivent être appliquées après que le pep gère cette notification pour un appareil qu’il possède.

Pour une notification PEP_DPM_UNREGISTER_DEVICE, la fonction AcceptDeviceNotification est toujours appelée avec IRQL = PASSIVE_LEVEL.

PEP_DPM_DEVICE_POWER_STATE

Notification (PEP_DPM_DEVICE_POWER_STATE)

Valeur PEP_DPM_DEVICE_POWER_STATE.

Données (PEP_DPM_DEVICE_POWER_STATE)

Pointeur vers une structure PEP_DEVICE_POWER_STATE .

Envoyé au PEP chaque fois que la pile de pilotes du dispositif demande une modification à un nouvel état d’alimentation Dx, ou qu'une transition précédemment demandée vers un état d’alimentation Dx s'achève.

Une fois que le PEP appelle la routine RequestWorker pour demander un élément de travail, PoFx répond en envoyant une notification PEP_DPM_DEVICE_POWER_STATE. Toutefois, cette notification n’est pas envoyée tant que les ressources (autrement dit, le thread de travail) nécessaires pour traiter l’élément de travail ne sont pas disponibles. De cette façon, PoFx garantit que la demande de travail que le PEP transmet à PoFx pendant la notification ne peut jamais échouer en raison d’un manque de ressources.

Pour envoyer une notification PEP_DPM_DEVICE_POWER_STATE, le système d’exploitation appelle la routine de rappel AcceptDeviceNotification du PEP. Dans cet appel, la valeur du paramètre de notification est PEP_DPM_DEVICE_POWER_STATE, et le paramètre Données pointe vers une structure PEP_DEVICE_POWER_STATE. À l'entrée, le PEP doit supposer que le contenu de cette structure n’est pas initialisé. Pour gérer cette notification, le PEP doit définir le membre WorkInformation pour qu'il pointe vers une structure PEP_WORK_INFORMATION allouée par le PEP qui décrit le travail demandé. En outre, le PEP doit définir le membre NeedWork de la structure de PEP_WORK sur TRUE pour confirmer que le PEP a géré la notification PEP_DEVICE_POWER_STATE et que le membre WorkInformation pointe vers une structure de PEP_WORK_INFORMATION valide. Si le PEP ne parvient pas à gérer la notification ou ne peut pas allouer la structure PEP_WORK_INFORMATION, le pep doit définir le membre WorkInformation sur NULL et définir le membre NeedWork sur FALSE.

Pour une notification de type PEP_DPM_DEVICE_POWER_STATE, la routine AcceptDeviceNotification est toujours appelée avec IRQL = PASSIVE_LEVEL.

PEP_DPM_COMPONENT_ACTIVE

Notification (PEP_DPM_COMPONENT_ACTIVE)

Valeur PEP_DPM_COMPONENT_ACTIVE.

Données (PEP_DPM_COMPONENT_ACTIVE)

Pointeur vers une structure PEP_COMPONENT_ACTIVE qui identifie le composant et qui indique si ce composant effectue une transition vers la condition active ou vers la condition inactive.

Informe le PEP qu’un composant doit effectuer une transition de la condition inactive à la condition active, ou inversement.

L’infrastructure de gestion de l’alimentation Windows (PoFx) envoie cette notification lorsqu’une transition est en attente à la condition active ou à la condition inactive.

Pour envoyer une notification PEP_DPM_COMPONENT_ACTIVE, PoFx appelle la routine de rappel AcceptDeviceNotification du PEP. Dans cet appel, la valeur du paramètre de notification est PEP_DPM_COMPONENT_ACTIVE, et le paramètre Données pointe vers une structure PEP_COMPONENT_ACTIVE.

Un composant accessible se trouve dans la condition active. Un composant inaccessible est dans la condition inactive. Un composant qui se trouve dans la condition active est toujours dans l’état d’alimentation du composant F0. Le composant ne peut pas quitter F0 tant qu’il n’entre pas dans la condition inactive. Un composant qui se trouve dans la condition inactive peut être en F0 ou dans un état Fx à faible puissance. La condition active/inactive d’un composant est le seul moyen fiable pour un pilote de déterminer si un composant est accessible. Un composant qui est en F0, mais qui est également dans la condition inactive peut être sur le point de basculer vers un état Fx à faible puissance.

Lorsqu’un composant actif est prêt à entrer dans la condition inactive, la transition se produit immédiatement. Pendant la gestion de la notification PEP_DPM_COMPONENT_ACTIVE, le PEP peut, par exemple, demander une transition de F0 à un état Fx de faible puissance pour le composant.

Si un composant est dans un état Fx à basse consommation lorsqu'une notification de PEP_DPM_COMPONENT_ACTIVE demande une transition de l'état inactif à l'état actif, le PEP doit d'abord passer le composant à F0 avant que celui-ci puisse entrer dans l'état actif. Le PEP pourrait devoir terminer la préparation du composant pour la transition vers l'état actif de manière asynchrone, après être revenu du rappel AcceptDeviceNotification pour la notification PEP_DPM_COMPONENT_ACTIVE. Une fois que le composant est entièrement configuré pour fonctionner dans la condition active, le pep doit appeler la routine RequestWorker, puis gérer la notification PEP_DPM_WORK résultante en définissant WorkType = PepWorkActiveComplete dans la structure PEP_WORK_INFORMATION.

Si le pep reçoit une notification de PEP_DPM_COMPONENT_ACTIVE pour un composant qui se trouve dans F0 et est déjà entièrement configuré pour fonctionner dans la condition active, le pep peut être en mesure de terminer la gestion de cette notification de façon synchrone. Si la gestion du "fast path" de la notification est prise en charge, le membre WorkInformation de la structure PEP_COMPONENT_ACTIVE de cette notification contient un pointeur vers une structure PEP_WORK_INFORMATION, et le PEP peut définir le membre WorkType de cette structure sur PepWorkActiveComplete pour terminer la transition. Toutefois, si WorkInformation = NULL, aucun « chemin rapide » n’est disponible et le PEP doit effectuer la transition de manière asynchrone en appelant RequestWorker, comme décrit dans le paragraphe précédent.

Pour plus d’informations sur les états actifs et inactifs, consultez Component-Level Gestion de l’alimentation.

Pour une notification PEP_DPM_COMPONENT_ACTIVE, la routine AcceptDeviceNotification est appelée à IRQL <= DISPATCH_LEVEL.

PEP_DPM_WORK

Notification (PEP_DPM_WORK)

La valeur PEP_DPM_WORK.

Données (PEP_DPM_WORK)

Pointeur vers une structure PEP_WORK .

Envoyé au PEP chaque fois que le PEP appelle la routine RequestWorker pour solliciter un élément de travail dans le cadre de l’infrastructure de gestion de l’alimentation Windows (PoFx).

Une fois que le PEP appelle la routine RequestWorker pour demander un élément de travail, PoFx répond en envoyant une notification PEP_DPM_WORK. Toutefois, cette notification n’est pas envoyée tant que les ressources (autrement dit, le thread de travail) nécessaires pour traiter l’élément de travail ne sont pas disponibles. De cette façon, PoFx garantit que la demande de travail que le PEP transmet à PoFx pendant la notification ne peut jamais échouer en raison d’un manque de ressources.

Pour envoyer une notification PEP_DPM_WORK, le système d’exploitation appelle la routine de rappel AcceptDeviceNotification du PEP. Dans cet appel, la valeur du paramètre notification est PEP_DPM_WORK, et le paramètre De données pointe vers une structure PEP_WORK. À l'entrée, le PEP doit supposer que le contenu de cette structure n’est pas initialisé. Pour gérer cette notification, le PEP doit définir le membre WorkInformation pour qu'il pointe vers une structure PEP_WORK_INFORMATION allouée par le PEP qui décrit le travail demandé. En outre, le PEP doit définir le membre NeedWork de la structure de PEP_WORK sur TRUE pour confirmer que le PEP a géré la notification PEP_DPM_WORK et que le membre WorkInformation pointe vers une structure de PEP_WORK_INFORMATION valide. Si le PEP ne parvient pas à gérer la notification ou ne peut pas allouer la structure PEP_WORK_INFORMATION, le pep doit définir le membre WorkInformation sur NULL et définir le membre NeedWork sur FALSE.

Pour une notification PEP_DPM_WORK, la routine AcceptDeviceNotification est toujours appelée lorsque IRQL = PASSIVE_LEVEL.

PEP_DPM_POWER_CONTROL_REQUEST

Notification (PEP_DPM_POWER_CONTROL_REQUEST)

La valeur PEP_DPM_POWER_CONTROL_REQUEST.

Données (PEP_DPM_POWER_CONTROL_REQUEST)

Pointeur vers une structure PEP_POWER_CONTROL_REQUEST .

Informe le PEP qu’un pilote a appelé l’API PoFxPowerControl pour envoyer un code de contrôle directement au PEP.

L’infrastructure de gestion de l’alimentation Windows (PoFx) envoie cette notification au pep lorsqu’un pilote appelle l’API PoFxPowerControl pour envoyer un code de contrôle directement au pep. Le pointeur de données de notification dans ce cas pointe vers la structure PEP_POWER_CONTROL_REQUEST

Les demandes de contrôle d’alimentation et leur sémantique sont définies entre l’enregistreur PEP et le propriétaire de la classe d’appareil. En règle générale, une telle interface est destinée à une communication spécifique à la classe d’appareil qui n’est pas capturée dans l’infrastructure de gestion de l’alimentation généralisée. Par exemple, le contrôleur UART peut communiquer des informations de taux de transmission au PEP pour modifier certains rails/diviseurs d’horloge de la plateforme, et cette communication utiliserait probablement une demande de contrôle d’alimentation.

![REMARQUE] Le PEP ne peut demander l'envoi d'un code de contrôle à l'appareil qu'après avoir reçu soit une notification PEP_DPM_DEVICE_STARTED, soit une notification PEP_DPM_POWER_CONTROL_REQUEST.

Pour une notification PEP_DPM_POWER_CONTROL_REQUEST, la routine AcceptDeviceNotification est appelée à IRQL <= DISPATCH_LEVEL.

PEP_DPM_POWER_CONTROL_COMPLETE

Notification (PEP_DPM_POWER_CONTROL_COMPLETE)

La valeur PEP_DPM_POWER_CONTROL_COMPLETE.

Données (PEP_DPM_POWER_CONTROL_COMPLETE)

Pointeur vers une structure PEP_POWER_CONTROL_COMPLETE .

Informe le PEP qu’un pilote a effectué une demande de contrôle d’alimentation qui a été émise précédemment par le PEP

L’infrastructure de gestion de l’alimentation Windows (PoFx) envoie cette notification au pep lorsqu’un pilote termine une demande de contrôle d’alimentation émise précédemment par le pep.

![REMARQUE] Le PEP peut ignorer cette notification s’il n’émet aucune requête de contrôle d’alimentation.

Pour une notification PEP_DPM_POWER_CONTROL_COMPLETE, la routine AcceptDeviceNotification est appelée à IRQL <= DISPATCH_LEVEL.

PEP_DPM_SYSTEM_LATENCY_UPDATE

Notification (PEP_DPM_SYSTEM_LATENCY_UPDATE)

La valeur PEP_DPM_SYSTEM_LATENCY_UPDATE.

Données (PEP_DPM_SYSTEM_LATENCY_UPDATE)

Pointeur vers une structure PEP_SYSTEM_LATENCY .

Informe le PEP que le système d’exploitation a mis à jour la tolérance de latence globale du système.

L’infrastructure de gestion de l’alimentation Windows (PoFx) envoie cette notification lorsque le système d’exploitation met à jour la tolérance globale de latence du système.

Dans les versions antérieures de PoFx, cette notification a été utilisée par le PEP pour la sélection de l’état d’inactivité du processeur et de la plateforme. Avec les dernières interfaces PEP, le processus de sélection est entièrement géré par le système d’exploitation et, par conséquent, cette notification n’est plus utile. Il est inclus ici pour l’exhaustivité et le PEP doit l’ignorer.

Pour envoyer une notification PEP_DPM_SYSTEM_LATENCY_UPDATE, PoFx appelle la routine de rappel AcceptDeviceNotification du PEP. Pour cette notification, la routine AcceptDeviceNotification est appelée à IRQL <= DISPATCH_LEVEL.

PEP_DPM_DEVICE_STARTED

Notification (PEP_DPM_DEVICE_STARTED)

La valeur PEP_DPM_DEVICE_STARTED.

Données (PEP_DPM_DEVICE_STARTED)

Pointeur vers une structure PEP_DEVICE_STARTED .

Informe le PEP que l’appareil a démarré afin qu’il soit disponible pour traiter des transactions de gestion de l’alimentation.

Les piles de dispositifs s’inscrivent auprès du système d’exploitation pour la gestion de l’alimentation à l’exécution dans un processus en deux phases. Le pilote appelle d’abord PoFxRegisterDevice pour fournir des informations sur le nombre de composants, leurs états inactifs et les attributs correspondants. En réponse à cet appel, le PEP reçoit une notification de type PEP_DPM_REGISTER_DEVICE.

Une fois l’inscription réussie, le pilote a la possibilité d’initialiser ses composants (par exemple, définir les exigences actives, mettre à jour les exigences de latence, mettre à jour la résidence inactive attendue, etc.). Une fois que le pilote a terminé toutes les tâches d’initialisation, il avertit le gestionnaire d’alimentation en appelant PoFxStartDevicePowerManagement. En réponse, le PEP recevra une notification de "PEP_DPM_DEVICE_STARTED". À ce stade, l’appareil est considéré comme entièrement activé pour la gestion de l’alimentation du runtime.

Par conséquent, le PEP ne peut émettre aucune demande de contrôle d’alimentation au pilote, sauf s’il a d’abord reçu une notification de PEP_DPM_DEVICE_STARTED ou une notification de PEP_DPM_POWER_CONTROL_REQUEST.

Pour une notification PEP_DPM_DEVICE_STARTED, la routine AcceptDeviceNotification est appelée à IRQL <= DISPATCH_LEVEL.

PEP_DPM_NOTIFY_COMPONENT_IDLE_STATE

Notification (PEP_DPM_NOTIFY_COMPONENT_IDLE_STATE)

La valeur PEP_DPM_NOTIFY_COMPONENT_IDLE_STATE.

Données (PEP_DPM_NOTIFY_COMPONENT_IDLE_STATE)

Pointeur vers une structure PEP_NOTIFY_COMPONENT_IDLE_STATE .

Envoyé au PEP lorsque le système d’exploitation émet une transition d’état inactif pour un composant donné.

L’infrastructure de gestion de l’alimentation Windows (PoFx) envoie cette notification lorsque le système d’exploitation émet une transition d’état inactif pour un composant donné.

Pour chaque transition d’état inactif, le PEP est averti avant et après que le pilote soit notifié. Le PEP fait la distinction entre les notifications antérieures et postérieures en examinant le membre DriverNotified de la structure PEP_NOTIFY_COMPONENT_IDLE_STATE. Pour une notification ultérieure, le membre DriverNotified sera TRUE.

Les pré-notifications sont généralement utilisées lors de la transition vers F0. Dans ce cas, le PEP peut avoir besoin de réactiver les ressources d’horloge ou d’alimentation afin que, lorsque le pilote gère la notification F0, le matériel soit disponible. En conséquence, les post-notifications sont généralement utilisées lors de la transition de F0 vers un état d’inactivité plus profond. Une fois qu’un pilote s'est occupé de la notification d'état de veille, le PEP peut désactiver sans risque les ressources d’horloge et d’alimentation.

La gestion d’une transition d’état inactif pour un composant donné peut nécessiter un traitement asynchrone si l’opération prend beaucoup de temps ou si l’IRQL est trop élevé pour effectuer la transition de façon synchrone. Par conséquent, le PEP peut terminer cette notification de façon synchrone ou asynchrone en définissant le membre COMPLETED sur TRUE ou FALSE respectivement.

Si la notification doit être effectuée de manière asynchrone, le PEP informe le système d'exploitation une fois terminée en demandant un agent de traitement (voir RequestWorker) et en complétant la structure d'informations de travail fournie dans la notification PEP_DPM_WORK résultante à l'aide d'un type de travail PepWorkCompleteIdleState.

Pour envoyer une notification PEP_DPM_NOTIFY_COMPONENT_IDLE_STATE, PoFx appelle la routine de rappel AcceptDeviceNotification du PEP. Cette routine est appelée à IRQL <= DISPATCH_LEVEL.

PEP_DPM_ENREGISTRER_DÉBOGUEUR

Notification (PEP_DPM_REGISTER_DEBUGGER)

Valeur PEP_DPM_REGISTER_DEBUGGER.

Données (PEP_DPM_REGISTER_DEBUGGER)

Pointeur vers une structure PEP_REGISTER_DEBUGGER .

Informe le PEP qu'un dispositif enregistré peut servir de port de débogage.

L’infrastructure de gestion de l’alimentation Windows (PoFx) envoie cette notification pour avertir le PEP qu’un appareil inscrit peut être utilisé comme port de débogage.

Pour une notification PEP_DPM_REGISTER_DEBUGGER, la routine AcceptDeviceNotification est appelée à IRQL <= DISPATCH_LEVEL.

PEP_DPM_LOW_POWER_EPOCH

Notification (PEP_DPM_LOW_POWER_EPOCH)

La valeur PEP_DPM_LOW_POWER_EPOCH.

Données (PEP_DPM_LOW_POWER_EPOCH)

Pointeur vers une structure PEP_LOW_POWER_EPOCH .

Cette notification est déconseillée.

PEP_DPM_REGISTER_CRASHDUMP_DEVICE

Notification (PEP_DPM_REGISTER_CRASHDUMP_DEVICE)

La valeur PEP_DPM_REGISTER_CRASHDUMP_DEVICE.

Données (PEP_DPM_REGISTER_CRASHDUMP_DEVICE)

Pointeur vers une structure PEP_REGISTER_CRASHDUMP_DEVICE.

L’infrastructure de gestion de l’alimentation Windows (PoFx) envoie cette notification lorsqu’un appareil s’inscrit en tant que gestionnaire crashdump.

La possibilité de générer un vidage de mémoire (crashdump) lorsque le système rencontre une erreur irrécupérable est inestimable pour déterminer la cause du plantage. Windows, par défaut, génère un fichier mémoire de crash lorsque le système rencontre une vérification de bogue. Dans ce contexte, le système fonctionne dans un environnement d'exploitation très contraint avec des interruptions désactivées et l'IRQL du système à HIGH_LEVEL.

Étant donné que les périphériques impliqués dans l’écriture d’un fichier de vidage sur incident sur disque (c’est-à-dire le contrôleur de stockage, le contrôleur PCI, etc.) peuvent être mis hors tension au moment de la panne, le système d’exploitation doit appeler le PEP pour alimenter le périphérique. Par conséquent, le système d’exploitation demande un rappel (PowerOnDumpDeviceCallback) à partir du pep pour chaque appareil sur la pile crashdump et appelle le rappel lors de la génération du fichier de vidage.

Étant donné l’environnement contraint au moment de l’incident, le rappel fourni par le pep ne doit pas accéder au code paginé, bloquer les événements ou appeler tout code qui peut faire de même. En outre, le processus d’alimentation des ressources requises ne peut pas s’appuyer sur des interruptions. Par conséquent, le PEP peut avoir à recourir à l’interrogation s’il doit attendre que différentes ressources soient activées. Si le PEP ne peut pas allumer l’appareil sous ces contraintes, il peut soit ne pas gérer la notification, soit ne pas fournir une fonction de rappel.

Pour envoyer une notification PEP_DPM_REGISTER_CRASHDUMP_DEVICE, PoFx appelle la routine de rappel AcceptDeviceNotification du PEP. Pour cette notification, la routine AcceptDeviceNotification est appelée à IRQL <= HIGH_LEVEL.

PEP_DPM_DEVICE_IDLE_CONSTRAINTS

Notification (PEP_DPM_DEVICE_IDLE_CONSTRAINTS)

La valeur PEP_DPM_DEVICE_IDLE_CONSTRAINTS.

Données (PEP_DPM_DEVICE_IDLE_CONSTRAINTS)

Pointeur vers une structure PEP_DEVICE_PLATFORM_CONSTRAINTS . Envoyé au PEP pour rechercher les dépendances entre les états D de l’appareil et les états d'inactivité de la plateforme.

L’infrastructure de gestion de l’alimentation Windows (PoFx) envoie cette notification au PEP pour interroger les dépendances entre les états D des appareils et les états inactifs de la plateforme. Le PEP utilise cette notification pour retourner à l'état D le plus léger dans lequel l'appareil peut encore se trouver et entrer dans chaque état d'inactivité de la plateforme. Le système d’exploitation garantit que l’appareil est dans le D-state minimum avant de passer à un état d’inactivité de plateforme associé. Si l'état inactif d'une plateforme ne dépend pas de cet appareil étant dans un quelconque état D, le PEP doit spécifier un état D minimal de PowerDeviceD0. Si aucun état d'inactivité de la plateforme ne dépend de ce dispositif dans un D-state particulier, cette notification peut être ignorée.

Cette notification est envoyée à chaque appareil une fois que le PEP a reçu la notification PEP_NOTIFY_PPM_QUERY_PLATFORM_STATES.

Pour envoyer une notification PEP_DPM_DEVICE_IDLE_CONSTRAINTS, PoFx appelle la routine de rappel AcceptDeviceNotification du PEP. Dans cet appel, la valeur du paramètre de notification est PEP_DPM_DEVICE_IDLE_CONSTRAINTS, et le paramètre De données pointe vers une structure PEP_DEVICE_PLATFORM_CONSTRAINTS.

Pour une notification PEP_DPM_DEVICE_IDLE_CONSTRAINTS, la routine AcceptDeviceNotification est toujours appelée à IRQL = DISPATCH_LEVEL.

PEP_DPM_COMPONENT_IDLE_CONSTRAINTS

Notification (PEP_DPM_COMPONENT_IDLE_CONSTRAINTS)

Valeur PEP_DPM_COMPONENT_IDLE_CONSTRAINTS.

Données (PEP_DPM_COMPONENT_IDLE_CONSTRAINTS)

Pointeur vers une structure PEP_COMPONENT_PLATFORM_CONSTRAINTS .

Envoyé au PEP pour interroger les dépendances entre les états F du composant et les états inactifs de la plateforme.

L’infrastructure de gestion de l’alimentation Windows (PoFx) envoie cette notification au PEP pour rechercher les dépendances entre les états F du composant et les états inactifs de la plateforme. Le PEP utilise cette notification pour déterminer l’état F le plus léger dans lequel le composant peut encore fonctionner et entrer dans chaque état inactif de la plateforme. Le système d’exploitation garantit que le composant est dans l’état F minimal avant d’entrer un état d’inactivité de plateforme associé. Si un état inactif de la plateforme ne dépend pas de ce composant étant dans n'importe quel état F, le PEP doit spécifier un état F minimum de 0. Si aucun état inactif de plateforme ne dépend de ce composant dans un état F particulier, cette notification peut être ignorée.

Les contraintes d’inactivité des appareils plus profondes que D0 sont plus contraignantes que les états inactifs des composants sur l’appareil. Pour un index d’état inactif de plateforme donné, si l’appareil a spécifié une contrainte d’inactivité de l’appareil, les contraintes d’inactivité du composant correspondant pour tous les composants associés à l’appareil sont ignorés.

Cette notification est envoyée à chaque composant sur chaque appareil après que le PEP a reçu une notification PEP_NOTIFY_PPM_QUERY_PLATFORM_STATES.

Pour envoyer une notification PEP_DPM_COMPONENT_IDLE_CONSTRAINTS, PoFx appelle la routine de rappel AcceptDeviceNotification du PEP. La routine AcceptDeviceNotification est toujours appelée à IRQL = DISPATCH_LEVEL.

PEP_DPM_QUERY_COMPONENT_PERF_CAPABILITIES

Notification (PEP_DPM_QUERY_COMPONENT_PERF_CAPABILITIES)

Valeur PEP_DPM_QUERY_COMPONENT_PERF_CAPABILITIES.

Données (PEP_DPM_QUERY_COMPONENT_PERF_CAPABILITIES)

Pointeur vers une structure PEP_QUERY_COMPONENT_PERF_CAPABILITIES .

Informe le PEP qu’il est interrogé pour le nombre d'ensembles d'états de performance (P-state) définis pour un composant.

Pour envoyer une notification PEP_DPM_QUERY_COMPONENT_PERF_CAPABILITIES, PoFx appelle la routine de rappel AcceptDeviceNotification du PEP. Dans cet appel, la valeur du paramètre de notification est PEP_DPM_QUERY_COMPONENT_PERF_CAPABILITIES, et le paramètre De données pointe vers une structure PEP_QUERY_COMPONENT_PERF_CAPABILITIES.

Pour une notification PEP_DPM_QUERY_COMPONENT_PERF_CAPABILITIES, la routine AcceptDeviceNotification est toujours appelée à IRQL = PASSIVE_LEVEL.

PEP_DPM_QUERY_COMPONENT_PERF_SET

Notification (PEP_DPM_QUERY_COMPONENT_PERF_SET)

Valeur PEP_DPM_QUERY_COMPONENT_PERF_SET.

Données (PEP_DPM_QUERY_COMPONENT_PERF_SET)

Pointeur vers une structure PEP_QUERY_COMPONENT_PERF_SET .

Informe le PEP qu'il est sollicité pour des informations concernant un ensemble de valeurs d'état de performance (jeu d'états P) pour un composant.

Pour envoyer une notification PEP_DPM_QUERY_COMPONENT_PERF_SET, PoFx appelle la routine de rappel AcceptDeviceNotification du PEP. Dans cet appel, la valeur du paramètre de notification est PEP_DPM_QUERY_COMPONENT_PERF_SET, et le paramètre De données pointe vers une structure PEP_QUERY_COMPONENT_PERF_SET.

Pour une notification PEP_DPM_QUERY_COMPONENT_PERF_SET, la routine AcceptDeviceNotification est toujours appelée à IRQL = PASSIVE_LEVEL.

PEP_DPM_QUERY_COMPONENT_PERF_SET_NAME

Notification (OPEP_DPM_QUERY_COMPONENT_PERF_SET_NAME)

Valeur PEP_DPM_QUERY_COMPONENT_PERF_SET_NAME.

Données (OPEP_DPM_QUERY_COMPONENT_PERF_SET_NAME)

Pointeur vers une structure PEP_QUERY_COMPONENT_PERF_SET_NAME .

Informe le PEP qu’il est interrogé pour obtenir des informations sur un ensemble de valeurs d’état de performance (ensemble d’états P) pour un composant.

Pour envoyer une notification PEP_DPM_QUERY_COMPONENT_PERF_SET_NAME, PoFx appelle la routine de rappel AcceptDeviceNotification du PEP. Dans cet appel, la valeur du paramètre de notification est PEP_DPM_QUERY_COMPONENT_PERF_SET_NAME, et le paramètre De données pointe vers une structure PEP_QUERY_COMPONENT_PERF_SET_NAME.

Pour une notification PEP_DPM_QUERY_COMPONENT_PERF_SET_NAME, la routine AcceptDeviceNotification est appelée toujours à IRQL = PASSIVE_LEVEL.

PEP_DPM_QUERY_COMPONENT_PERF_STATES

Notification (PEP_DPM_QUERY_COMPONENT_PERF_STATES)

La valeur PEP_DPM_QUERY_COMPONENT_PERF_STATES.

Données (PEP_DPM_QUERY_COMPONENT_PERF_STATES)

Pointeur vers une structure PEP_QUERY_COMPONENT_PERF_STATES .

Informe le PEP qu’il est interrogé pour obtenir une liste de valeurs d’état de performance discret (P-state) pour un ensemble d’états P spécifié.

Pour envoyer une notification PEP_DPM_QUERY_COMPONENT_PERF_STATES, PoFx appelle la routine de rappel AcceptDeviceNotification du PEP. Dans cet appel, la valeur du paramètre de notification est PEP_DPM_QUERY_COMPONENT_PERF_STATES, et le paramètre De données pointe vers une structure PEP_QUERY_COMPONENT_PERF_STATES.

Pour une notification PEP_DPM_QUERY_COMPONENT_PERF_STATES, la routine AcceptDeviceNotification est toujours appelée à IRQL = PASSIVE_LEVEL.

PEP_DPM_REGISTER_COMPONENT_PERF_STATES

Notification (PEP_DPM_REGISTER_COMPONENT_PERF_STATES)

La valeur PEP_DPM_REGISTER_COMPONENT_PERF_STATES.

Données (PEP_DPM_REGISTER_COMPONENT_PERF_STATES)

Pointeur vers une structure PEP_REGISTER_COMPONENT_PERF_STATES .

Informe le PEP sur les états de performance (états P) du composant spécifié.

Pour envoyer une notification PEP_DPM_REGISTER_COMPONENT_PERF_STATES, PoFx appelle la routine de rappel AcceptDeviceNotification du PEP. Dans cet appel, la valeur du paramètre de notification est PEP_DPM_REGISTER_COMPONENT_PERF_STATES, et le paramètre De données pointe vers une structure PEP_REGISTER_COMPONENT_PERF_STATES.

Pour une notification de type PEP_DPM_REGISTER_COMPONENT_PERF_STATES, la routine AcceptDeviceNotification est toujours appelée avec un IRQL au niveau PASSIVE_LEVEL.

PEP_DPM_REQUEST_COMPONENT_PERF_STATE

Notification (PEP_DPM_REQUEST_COMPONENT_PERF_STATE)

La valeur PEP_DPM_REQUEST_COMPONENT_PERF_STATE.

Données (PEP_DPM_REQUEST_COMPONENT_PERF_STATE)

Pointeur vers une structure PEP_REQUEST_COMPONENT_PERF_STATE.

Cela informe le PEP qu'une ou plusieurs modifications d’état de performances (P-state) sont demandées par l'infrastructure de gestion de l'alimentation Windows (PoFx).

Pour envoyer une notification de type PEP_DPM_REQUEST_COMPONENT_PERF_STATE, PoFx appelle la routine de rappel AcceptDeviceNotification du PEP. Dans cet appel, la valeur du paramètre de notification est PEP_DPM_REQUEST_COMPONENT_PERF_STATE, et le paramètre Données pointe vers une structure PEP_REQUEST_COMPONENT_PERF_STATE.

Pour une notification PEP_DPM_REQUEST_COMPONENT_PERF_STATE, la routine AcceptDeviceNotification est toujours appelée à IRQL = PASSIVE_LEVEL.

PEP_DPM_QUERY_CURRENT_COMPONENT_PERF_STATE

Notification (PEP_DPM_QUERY_CURRENT_COMPONENT_PERF_STATE)

La valeur PEP_DPM_QUERY_CURRENT_COMPONENT_PERF_STATE.

Données (PEP_DPM_QUERY_CURRENT_COMPONENT_PERF_STATE)

Pointeur vers une structure PEP_QUERY_CURRENT_COMPONENT_PERF_STATE.

Informe le PEP qu'il est interrogé pour obtenir des informations sur l'état P actuel dans l'ensemble d'états P spécifié.

Pour envoyer une notification PEP_DPM_QUERY_CURRENT_COMPONENT_PERF_STATE, PoFx appelle la routine de rappel AcceptDeviceNotification du PEP. Dans cet appel, la valeur du paramètre de notification est PEP_DPM_QUERY_CURRENT_COMPONENT_PERF_STATE, et le paramètre Données pointe vers une structure PEP_QUERY_CURRENT_COMPONENT_PERF_STATE.

Pour une notification PEP_DPM_QUERY_CURRENT_COMPONENT_PERF_STATE, la routine AcceptDeviceNotification est toujours appelée au niveau IRQL = PASSIVE_LEVEL.

PEP_DPM_QUERY_DEBUGGER_TRANSITION_REQUIREMENTS

Notification (PEP_DPM_QUERY_DEBUGGER_TRANSITION_REQUIREMENTS)

Valeur PEP_DPM_QUERY_DEBUGGER_TRANSITION_REQUIREMENTS.

Données (PEP_DPM_QUERY_DEBUGGER_TRANSITION_REQUIREMENTS)

Pointeur vers une structure PEP_DEBUGGER_TRANSITION_REQUIREMENTS.

Envoyé au PEP pour interroger l’ensemble des états coordonnés ou de plateforme qui requièrent que le débogueur soit éteint.

L’infrastructure de gestion de l’alimentation Windows (PoFx) envoie cette notification au pep pour rechercher l’ensemble d’états coordonnés ou de plateforme qui nécessitent que le débogueur soit éteint. Si cette notification est acceptée, le système d’exploitation effectue toutes les transitions d’alimentation du débogueur pour le PEP, et le PEP n'est pas autorisé à utiliser TransitionCriticalResource pour gérer le débogueur.

Cette notification est envoyée à chaque dispositif de débogueur une fois que le PEP a accepté une notification PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE ou PEP_NOTIFY_PPM_QUERY_COORDINATED_STATES.

Pour qu'une notification PEP_DPM_QUERY_DEBUGGER_TRANSITION_REQUIREMENTS soit envoyée, PoFx appelle la routine de rappel AcceptDeviceNotification du PEP. Pour cette notification, la routine AcceptDeviceNotification est toujours appelée à IRQL = DISPATCH_LEVEL.

PEP_DPM_QUERY_SOC_SUBSYSTEM

Notification (PEP_DPM_QUERY_SOC_SUBSYSTEM)

La valeur PEP_DPM_QUERY_SOC_SUBSYSTEM.

Données (PEP_DPM_QUERY_SOC_SUBSYSTEM)

Pointeur vers une structure PEP_QUERY_SOC_SUBSYSTEM .

Envoyé au PEP pour collecter des informations de base sur un système particulier sur un sous-système de puce (SoC).

L’infrastructure de gestion de l’alimentation Windows (PoFx) envoie cette notification au PEP après l’initialisation des états de veille de la plateforme afin de recueillir des informations de base sur un sous-système SoC particulier. Un pep qui n’implémente pas la comptabilité du sous-système SoC ou ne l’implémente pas pour l’état inactif de la plateforme spécifiée, retourne FALSE. Cela permet au système d’exploitation d’arrêter d’envoyer des notifications de diagnostic au PEP pour cet état d'inactivité de plateforme.

Le nombre de sous-systèmes d'un système et le nombre de métadonnées d’un sous-système peuvent changer avec les mises à jour PEP/BSP. Sous-systèmeIndex peut changer chaque fois que le système d’exploitation démarre.

Pour envoyer une notification PEP_DPM_QUERY_SOC_SUBSYSTEM, PoFx appelle la routine de rappel AcceptDeviceNotification du PEP au DISPATCH_LEVEL IRQL < .

PEP_DPM_QUERY_SOC_SUBSYSTEM_BLOCKING_TIME

Notification (PEP_DPM_QUERY_SOC_SUBSYSTEM_BLOCKING_TIME)

Valeur PEP_DPM_QUERY_SOC_SUBSYSTEM_BLOCKING_TIME.

Données (PEP_DPM_QUERY_SOC_SUBSYSTEM_BLOCKING_TIME)

Un pointeur vers une structure PEP_QUERY_SOC_SUBSYSTEM_BLOCKING_TIME.

Envoyé au PEP lorsque le système d’exploitation souhaite collecter le temps pendant lequel un sous-système particulier sur un système sur puce (SoC) a bloqué l’entrée dans un état d'inactivité spécifique de la plateforme sans que le système d'exploitation le sache.

En règle générale, le système d'exploitation appelle cette notification à la fin d'une session de veille connectée prolongée où le système d'exploitation a tenté d'entrer dans l'état d'inactivité de la plateforme spécifié. Le PEP_QUERY_SOC_SUBSYSTEM_COUNT SubsystemCount, renseignée précédemment par le PEP lors de l'initialisation des sous-composants, spécifie le nombre de notifications PEP_DPM_QUERY_SOC_SUBSYSTEM_BLOCKING_TIME envoyées au PEP simultanément. Un PEP est capable de recevoir plusieurs notifications PEP_DPM_QUERY_SOC_SUBSYSTEM_BLOCKING_TIME pour un sous-système donné. Ces notifications peuvent ou ne pas être entrelacées avec des notifications PEP_DPM_RESET_SOC_SUBSYSTEM_ACCOUNTING.

Pour envoyer une notification PEP_DPM_QUERY_SOC_SUBSYSTEM_BLOCKING_TIME, PoFx appelle la routine de rappel AcceptDeviceNotification du PEP au DISPATCH_LEVEL IRQL < .

PEP_DPM_QUERY_SOC_SUBSYSTEM_COUNT

Notification (PEP_DPM_QUERY_SOC_SUBSYSTEM_COUNT)

Valeur PEP_DPM_QUERY_SOC_SUBSYSTEM_COUNT.

Données (PEP_DPM_QUERY_SOC_SUBSYSTEM_COUNT)

Pointeur vers une structure PEP_QUERY_SOC_SUBSYSTEM_COUNT .

Envoyé au pep après que les états inactifs de la plateforme ont été initialisés pour indiquer au système d’exploitation si le PEP prend en charge le système sur un sous-système de puce (SoC) représentant un état inactif de plateforme donné.

Il s’agit de la première notification de diagnostic du sous-système SoC envoyée au pep. Un PEP qui n’implémente pas la comptabilité du sous-système SoC, ou ne l’implémente pas pour l’état inactif de la plateforme spécifiée, retourne FALSE. Dans ce cas, le système d’exploitation n’enverra plus de notifications de diagnostic du sous-système SoC pour cet état inactif de plateforme.

Pour envoyer une notification PEP_DPM_QUERY_SOC_SUBSYSTEM_COUNT, PoFx appelle la routine de rappel AcceptDeviceNotification du PEP au DISPATCH_LEVEL IRQL < .

PEP_DPM_QUERY_SOC_SUBSYSTEM_METADATA

Notification (PEP_DPM_QUERY_SOC_SUBSYSTEM_METADATA)

La valeur PEP_DPM_QUERY_SOC_SUBSYSTEM_METADATA.

Données (PEP_DPM_QUERY_SOC_SUBSYSTEM_METADATA)

Pointeur vers une structure PEP_QUERY_SOC_SUBSYSTEM_METADATA.

Envoyé au pep pour collecter des métadonnées facultatives sur le sous-système dont le temps de blocage vient d’être interrogé.

Cette notification est généralement envoyée au PEP immédiatement après la notification PEP_DPM_QUERY_SOC_SUBSYSTEM_BLOCKING_TIME. Une notification PEP_DPM_QUERY_SOC_SUBSYSTEM_METADATA collecte toutes les paires de métadonnées clé-valeur décrivant le sous-système.

Pour envoyer une notification PEP_DPM_QUERY_SOC_SUBSYSTEM_METADATA, PoFx appelle la routine de rappel AcceptDeviceNotification du PEP. Pour cette notification, la routine AcceptDeviceNotification est appelée à IRQL DISPATCH_LEVEL <.

PEP_DPM_RESET_SOC_SUBSYSTEM_ACCOUNTING

Notification (PEP_DPM_RESET_SOC_SUBSYSTEM_ACCOUNTING)

Valeur PEP_DPM_RESET_SOC_SUBSYSTEM_ACCOUNTING.

Données (PEP_DPM_RESET_SOC_SUBSYSTEM_ACCOUNTING)

Pointeur vers une structure PEP_RESET_SOC_SUBSYSTEM_ACCOUNTING. structure.

Envoyé au PEP pour effacer l’heure de blocage du sous-système et la comptabilité des métadonnées, effectuer toute initialisation supplémentaire requise et redémarrer la comptabilité.

L’infrastructure de gestion de l’alimentation Windows (PoFx) envoie cette notification au pep chaque fois que tous les sous-systèmes sont initialisés avec le système d’exploitation. En règle générale, cette notification est appelée lorsque le système d’exploitation commence une nouvelle période d’analyse autour de ce qui maintient le système sur une puce (SoC) hors de l’état d’inactivité de la plateforme spécifiée (ciblant drIPS lors de l’entrée en veille connectée). Le système d’exploitation envoie uniquement cette notification pour les états inactifs de la plateforme pour lesquels le PEP a initialisé un ou plusieurs sous-systèmes SoC.

Pour envoyer une notification PEP_DPM_RESET_SOC_SUBSYSTEM_ACCOUNTING, PoFx appelle la routine de rappel AcceptDeviceNotification du PEP au niveau IRQL < DISPATCH_LEVEL.