Fonction PoFxSetComponentWake (wdm.h)

  • Article

La routine PoFxSetComponentWake indique si le pilote force le composant spécifié à se réveiller chaque fois que le composant entre dans l’état d’inactivité.

Syntaxe

void PoFxSetComponentWake(
  [in] POHANDLE Handle,
  [in] ULONG    Component,
  [in] BOOLEAN  WakeHint
);

Paramètres

[in] Handle

Handle qui représente l’inscription de l’appareil auprès de l’infrastructure de gestion de l’alimentation (PoFx). Le pilote de périphérique a déjà reçu ce handle de la routine PoFxRegisterDevice .

[in] Component

Index qui identifie le composant. Ce paramètre est un index dans le tableau Components de la structure PO_FX_DEVICE que le pilote de périphérique a utilisé pour inscrire l’appareil auprès de PoFx. Si le tableau Composants contient N éléments, les index des composants vont de 0 à N–1.

[in] WakeHint

Indique si le pilote active le composant pour qu’il se réveille chaque fois que le composant entre dans la condition d’inactivité. Si la valeur est TRUE, le pilote arme le composant pour qu’il se réveille. Si la valeur est FALSE, le pilote n’arme pas le composant pour qu’il se réveille.

Valeur de retour

None

Remarques

Avant qu’un composant n’entre dans un état Fx de faible consommation, le pilote peut armer le composant pour qu’il se réveille automatiquement en réponse à un signal d’entrée provenant d’une source externe (par exemple, si l’utilisateur appuie sur un bouton). Le paramètre WakeHint indique à PoFx si le pilote met le composant en éveil. Si un composant est armé pour se réveiller, PoFx ne basculera pas le composant vers un état Fx de faible puissance à partir duquel le composant ne peut pas se réveiller.

Lorsqu’un appareil est inscrit auprès de PoFx, les informations d’inscription de chaque composant de l’appareil sont contenues dans une structure PO_FX_COMPONENT distincte. Le membre DeepestWakeableIdleState de cette structure spécifie l’état Fx le plus profond à partir duquel le composant peut se réveiller.

Le pilote de périphérique peut appeler PoFxSetComponentWake chaque fois qu’un changement de conditions nécessite une modification de la valeur WakeHint . Après chaque appel, la nouvelle valeur WakeHint reste en vigueur jusqu’à ce que le pilote appelle à nouveau PoFxSetComponentWake pour le mettre à jour.

Si un composant est en état d’inactivité lorsque PoFxSetComponentWake est appelé, PoFx peut modifier l’état Fx du composant pour prendre en charge la nouvelle valeur du paramètre WakeHint spécifiée par l’appelant.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible à partir de Windows 8.
Plateforme cible Universal
En-tête wdm.h
Bibliothèque Ntoskrnl.lib
DLL Ntoskrnl.exe
IRQL <= DISPATCH_LEVEL

Voir aussi

PO_FX_COMPONENT