Fonction PoFxSetComponentWake (wdm.h)
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 |