énumération POWER_REQUEST_TYPE (ntpoapi.h)

Article
08/07/2023

L’énumération POWER_REQUEST_TYPE indique le type de demande d’alimentation.

Syntax

typedef enum _POWER_REQUEST_TYPE {
  PowerRequestDisplayRequired,
  PowerRequestSystemRequired,
  PowerRequestAwayModeRequired,
  PowerRequestExecutionRequired
} POWER_REQUEST_TYPE, *PPOWER_REQUEST_TYPE;

Constantes


`PowerRequestDisplayRequired` Non utilisé par les pilotes. Pour plus d'informations, consultez la section Notes.
`PowerRequestSystemRequired` Empêche l’ordinateur d’entrer automatiquement en mode veille après une période d’inactivité de l’utilisateur.
`PowerRequestAwayModeRequired` Non utilisé par les pilotes. Pour plus d'informations, consultez la section Notes.
`PowerRequestExecutionRequired` Non utilisé par les pilotes. Pour plus d'informations, consultez la section Notes.

Remarques

Cette énumération est utilisée par les routines PoClearPowerRequest et PoSetPowerRequest en mode noyau. Les pilotes qui appellent ces routines doivent spécifier la valeur d’énumération PowerRequestSystemRequired .

Les trois autres valeurs d’énumération (PowerRequestDisplayRequired, PowerRequestAwayModeRequired et PowerRequestExecutionRequired) ne sont pas utilisées par les pilotes. Les applications spécifient ces types de demande d’alimentation dans les appels aux fonctions PowerSetRequest et PowerClearRequest .

Une demande d’alimentation PowerRequestDisplayRequired a les effets suivants :

Après une période d’inactivité de l’utilisateur, l’affichage de la session reste activé et ne s’éteint pas automatiquement. Si l’affichage est déjà désactivé, la demande d’alimentation active l’affichage.
Un écran de veille ne démarre pas automatiquement après une période d’inactivité de l’utilisateur. Si un écran de veille est déjà en cours d’exécution, la demande d’alimentation arrête l’écran de veille.
La session ne sera pas automatiquement verrouillée après une période d’inactivité de l’utilisateur. Si la session est déjà verrouillée lorsque le pilote envoie la demande d’alimentation, la session reste verrouillée.

Alors qu’une demande d’alimentation PowerRequestAwayModeRequired est en vigueur, si l’utilisateur tente de mettre l’ordinateur en mode veille (par exemple, en cliquant sur Démarrer , puis en cliquant sur Veille), le gestionnaire d’alimentation désactive l’audio et la vidéo afin que l’ordinateur semble être en mode veille, mais l’ordinateur continue de s’exécuter.

Alors qu’une demande d’alimentation PowerRequestExecutionRequired est en vigueur, le processus appelant continue de s’exécuter au lieu d’être suspendu ou arrêté par des mécanismes de gestion de la durée de vie des processus (PLM). Le moment et la durée d’exécution du processus dépendent des paramètres du système d’exploitation et de la stratégie d’alimentation. Ce type de demande d’alimentation est pris en charge à partir de Windows 8.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Pris en charge à partir de Windows 7.
En-tête	ntpoapi.h (inclure Wdm.h, Ntddk.h, Ntifs.h, Ntpoapi.h)

Voir aussi