IPowerPolicyCallbackWakeFromSx ::OnArmWakeFromSx, méthode (wudfddi.h)
[Avertissement : UMDF 2 est la dernière version de UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide de UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et il existe une prise en charge limitée de UMDF 1 sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Bien démarrer avec UMDF.]
Un pilote OnArmWakeFromSx bras de fonction de rappel d’événement (autrement dit, active) un appareil afin qu’il puisse déclencher un signal de veille alors qu’il est dans un état d’appareil à faible alimentation. Le signal de veille entraîne l’entrée de l’appareil dans son état de fonctionnement (D0) et le système à entrer dans son état de travail (S0).
Syntaxe
HRESULT OnArmWakeFromSx(
[in] IWDFDevice *pWdfDevice
);
Paramètres
[in] pWdfDevice
Pointeur vers l’interface IWDFDevice de l’objet d’appareil qui représente l’un des appareils du pilote.
Valeur de retour
Si l’opération réussit, la fonction de rappel OnArmWakeFromSx doit retourner S_OK ou une autre valeur d’état pour laquelle SUCCEEDED(status) est égal à TRUE. Sinon, il doit retourner une valeur d’état pour laquelle SUCCEEDED(status) est égal à FALSE.
Si SUCCEEDED(status) est égal FALSE, l’infrastructure appelle la fonction de rappel IPowerPolicyCallbackWakeFromSx ::OnDisarmWakeFromSx du pilote. (L’infrastructure ne signale pas de défaillance d’appareil au gestionnaire PnP.)
Remarques
Votre pilote doit fournir une fonction de rappel OnArmWakeFromSx si le pilote prend en charge l’interface IPowerPolicyCallbackWakeFromSx.
Cette fonction de rappel gère les opérations spécifiques à l’appareil nécessaires pour permettre à l’appareil de détecter un événement externe qui déclenche un signal de veille sur le bus. Le pilote de bus en mode noyau gère des opérations spécifiques au bus, telles que l’activation du signal PME (Power Management Event) du bus PCI.
Si un pilote a inscrit un OnArmWakeFromSx fonction de rappel, l’infrastructure l’appelle alors que l’appareil est toujours dans l’état d’alimentation de l’appareil D0, avant que le pilote de bus réduise l’état d’alimentation de l’appareil, mais une fois que l’infrastructure a envoyé un IRP d’attente/éveil au nom du pilote.
Le processus se produit dans la séquence suivante :
- Le framework détermine que le système est sur le point d’entrer dans un état de système à faible alimentation.
- L’infrastructure appelle la fonction de rappel OnArmWakeFromSx du pilote.
- Le framework demande au pilote que le bus de l’appareil diminue la puissance de l’appareil.
Pour plus d’informations sur le moment où l’infrastructure appelle cette fonction de rappel, consultez Scénarios pnP et de gestion de l’alimentation dans UMDF.
Vous n’avez pas besoin de fournir une fonction de rappel OnArmWakeFromSx si votre appareil ne nécessite pas d’opérations matérielles spéciales qui permettent à l’appareil de déclencher un signal de veille.
Pour plus d’informations sur cette fonction de rappel, consultez prise en charge du système Wake-Up dans les pilotes basés sur UMDF.
Exigences
| Exigence | Valeur |
|---|---|
| fin du support | Indisponible dans UMDF 2.0 et versions ultérieures. |
| plateforme cible | Bureau |
| version minimale de UMDF | 1.9 |
| d’en-tête | wudfddi.h (include Wudfddi.h) |
Voir aussi
IPowerPolicyCallbackWakeFromSx