Prise en charge des Wake-Up système dans les pilotes UMDF

Avertissement

UMDF 2 est la dernière version d’UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide d’UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et la prise en charge d’UMDF 1 est limitée sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2.

Les exemples UMDF 1 archivés se trouvent dans la Windows 11, version 22H2 - Mise à jour des exemples de pilotes de mai 2022.

Pour plus d’informations, consultez Prise en main avec UMDF.

Lorsque le système est à faible consommation d’énergie, certains appareils peuvent détecter un événement externe, tel qu’un paquet réseau entrant, puis mettre le système en éveil. Par exemple, si un appareil PCI dispose d’une fonctionnalité de mise en éveil du système, comme indiqué dans le registre des fonctionnalités de gestion de l’alimentation (PMC) de l’appareil, il réveille le système en déclenchant le signal de l’événement de gestion de l’alimentation (PME) sur le bus PCI.

Si votre appareil peut sortir le système d’un état de faible consommation à l’échelle du système, la fonction de rappel IDriverEntry::OnDeviceAdd dans le propriétaire de la stratégie d’alimentation doit effectuer les deux étapes suivantes :

1. Appelez IWDFDevice2::AssignSxWakeSettings pour spécifier :

   • État de faible consommation que l’appareil entrera
   • Si les utilisateurs peuvent contrôler les paramètres inactifs de l’appareil
   • Si la fonctionnalité de veille de l’appareil est activée ou désactivée

2. Implémentez l’interface IPowerPolicyCallbackWakeFromSx et les fonctions de rappel d’événements suivantes, si vous en avez besoin pour votre appareil :

   • IPowerPolicyCallbackWakeFromSx::OnArmWakeFromSx, qui permet au matériel de l’appareil de répondre à un événement de mise en éveil externe.
   • IPowerPolicyCallbackWakeFromSx::OnDisarmWakeFromSx, qui désactive la capacité de l’appareil à répondre à un événement de veille externe.
   • IPowerPolicyCallbackWakeFromSx::OnWakeFromSxTriggered, qui informe le pilote que le bus a détecté un signal de veille.

Les conducteurs de bus participent également au réveil du système. Le pilote en mode noyau pour le bus de l’appareil fait tout ce qui est nécessaire sur l’adaptateur de bus pour activer et désactiver la capacité d’un appareil à se réveiller à partir d’un état de faible consommation.

Pour plus d’informations sur les entrées de Registre qui contrôlent les fonctionnalités de veille d’un appareil, consultez Contrôle utilisateur de l’appareil inactif et comportement de veille dans UMDF.