Fonction PoSetSystemState (wdm.h)
Les pilotes appellent la routine PoSetSystemState pour indiquer que le système est actif.
Syntaxe
void PoSetSystemState(
[in] EXECUTION_STATE Flags
);
Paramètres
[in] Flags
Indique l’activité système, comme spécifié par un OR au niveau du bit d’une ou plusieurs des valeurs suivantes :
ES_SYSTEM_REQUIRED
Le système n’est pas inactif, quelle que soit la charge apparente.
ES_DISPLAY_REQUIRED
L’utilisation de l’affichage est requise.
ES_USER_PRESENT
Un utilisateur est présent.
Valeur de retour
None
Remarques
Un pilote appelle PoSetSystemState pour définir des indicateurs indiquant que l’activité système se produit. Contrairement à PoRegisterSystemState, cette routine ne permet pas au pilote de définir un état d’occupation persistant.
Le paramètre Flags spécifie le type d’activité qui se produit. Les pilotes peuvent spécifier n’importe quelle combinaison des indicateurs.
Les pilotes peuvent définir l’état d’activité du système pour demander au système d’éviter de quitter l’état de fonctionnement pendant que l’activité du pilote se produit. Notez toutefois que dans certaines circonstances (comme une batterie très faible), le gestionnaire d’alimentation peut remplacer cette demande et mettre le système en veille de toute façon.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Disponible à partir de Windows 2000. |
Plateforme cible | Universal |
En-tête | wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h) |
Bibliothèque | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | <=DISPATCH_LEVEL |