EVT_WDF_DEVICE_WAKE_FROM_SX_TRIGGERED fonction de rappel (wdfdevice.h)

Article
02/26/2024

[S’applique à KMDF et UMDF]

La fonction de rappel d’événement EvtDeviceWakeFromSxTriggered d’un pilote informe le pilote que son appareil, qui était précédemment entré dans un état d’appareil de faible consommation en raison de la réduction de l’alimentation du système, a pu déclencher un signal de veille.

Syntaxe

EVT_WDF_DEVICE_WAKE_FROM_SX_TRIGGERED EvtWdfDeviceWakeFromSxTriggered;

void EvtWdfDeviceWakeFromSxTriggered(
  [in] WDFDEVICE Device
)
{...}

Paramètres

[in] Device

Handle d’un objet d’appareil framework.

Valeur de retour

None

Remarques

Pour inscrire une fonction de rappel EvtDeviceWakeFromSxTriggered , un pilote doit appeler WdfDeviceInitSetPowerPolicyEventCallbacks.

Si le pilote a inscrit ce rappel, l’infrastructure l’appelle après avoir appelé la fonction de rappel EvtDeviceD0Entry du pilote et avant d’appeler la fonction de rappel EvtDeviceDisarmWakeFromSx du pilote.

Le matériel système (BIOSes, cartes mères, adaptateurs de bus) peut parfois lever un signal de veille avant que le pilote de bus ne le détecte, même si le signal réveille le système. Dans ce cas, la fonction de rappel EvtDeviceWakeFromSxTriggered du pilote n’est pas appelée même si l’appareil du pilote a déclenché un signal de veille.

Certains bus combinent les signaux de veille de plusieurs enfants. Si votre appareil est connecté à l’un de ces bus, la fonction de rappel peut devoir déterminer si l’appareil actuel a déclenché le signal de réveil. Si votre appareil fournit un verrou matériel qui enregistre l’état déclenché de l’appareil, il est préférable de case activée cet état dans la fonction de rappel EvtDeviceDisarmWakeFromSx du pilote, car ce rappel est toujours appelé après le réveil de l’appareil, même si le signal de veille a été supprimé.

Pour plus d’informations sur cette fonction de rappel, consultez Prise en charge de la mise en éveil du système.