Méthode IPowerPolicyCallbackWakeFromSx ::OnArmWakeFromSx (wudfddi.h)

  • Article

[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. Pour plus d’informations, consultez Prise en main avec UMDF.]

Les bras de la fonction de rappel d’événement OnArmWakeFromSx d’un pilote (c’est-à-dire, active) un appareil afin qu’il puisse déclencher un signal de veille lorsqu’il est dans un état de périphérique à faible consommation. Le signal de sortie de veille entraîne l’entrée de l’appareil dans son état de fonctionnement (D0) et le système dans son état de fonctionnement (S0).

Syntaxe

HRESULT OnArmWakeFromSx(
  [in] IWDFDevice *pWdfDevice
);

Paramètres

[in] pWdfDevice

Pointeur vers l’interface IWDFDevice de l’objet de périphérique qui représente l’un des périphériques du pilote.

Valeur retournée

Si l’opération réussit, la fonction de rappel OnArmWakeFromSx doit retourner S_OK ou une autre valeur de status pour laquelle SUCCEEDED(status) est égal à TRUE. Sinon, elle doit retourner une valeur status 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 une 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 qui sont 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 une fonction de rappel OnArmWakeFromSx , l’infrastructure l’appelle alors que l’appareil est toujours dans l’état d’alimentation du périphérique D0, avant que le pilote de bus baisse l’état d’alimentation de l’appareil, mais une fois que l’infrastructure a envoyé une IRP d’attente/veille pour le compte du pilote.

Le processus se produit dans l’ordre suivant :

  1. L’infrastructure détermine que le système est sur le point d’entrer dans un état de système à faible consommation d’énergie.
  2. Le framework appelle la fonction de rappel OnArmWakeFromSx du pilote.
  3. L’infrastructure demande au pilote pour le bus de l’appareil de réduire l’alimentation de l’appareil.
Immédiatement avant qu’un appareil n’entre dans un état de faible consommation, l’infrastructure appelle la fonction de rappel IPnpCallback ::OnD0Exit du pilote.

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 des Wake-Up système dans les pilotes UMDF.

Configuration requise

Condition requise Valeur
Fin de la prise en charge Non disponible dans UMDF 2.0 et versions ultérieures.
Plateforme cible Desktop (Expérience utilisateur)
Version UMDF minimale 1,9
En-tête wudfddi.h (inclure Wudfddi.h)

Voir aussi

IPowerPolicyCallbackWakeFromSx

IPowerPolicyCallbackWakeFromSx ::OnDisarmWakeFromSx

IPowerPolicyCallbackWakeFromSx ::OnWakeFromSxTriggered