structure USER_POWER_POLICY (powrprof.h)
Contient des paramètres de stratégie d’alimentation qui sont propres à chaque schéma d’alimentation d’un utilisateur. Cette structure fait partie de la structure POWER_POLICY .
Syntaxe
typedef struct _USER_POWER_POLICY {
ULONG Revision;
POWER_ACTION_POLICY IdleAc;
POWER_ACTION_POLICY IdleDc;
ULONG IdleTimeoutAc;
ULONG IdleTimeoutDc;
UCHAR IdleSensitivityAc;
UCHAR IdleSensitivityDc;
UCHAR ThrottlePolicyAc;
UCHAR ThrottlePolicyDc;
SYSTEM_POWER_STATE MaxSleepAc;
SYSTEM_POWER_STATE MaxSleepDc;
ULONG Reserved[2];
ULONG VideoTimeoutAc;
ULONG VideoTimeoutDc;
ULONG SpindownTimeoutAc;
ULONG SpindownTimeoutDc;
BOOLEAN OptimizeForPowerAc;
BOOLEAN OptimizeForPowerDc;
UCHAR FanThrottleToleranceAc;
UCHAR FanThrottleToleranceDc;
UCHAR ForcedThrottleAc;
UCHAR ForcedThrottleDc;
} USER_POWER_POLICY, *PUSER_POWER_POLICY;
Membres
Revision
Niveau de révision de structure actuel. Définissez cette valeur en appelant GetCurrentPowerPolicies ou ReadPwrScheme avant d’utiliser une structure USER_POWER_POLICY pour définir une stratégie d’alimentation.
IdleAc
Une structure POWER_ACTION_POLICY qui définit l’action d’alimentation du système à lancer lorsque le système s’exécute sur l’alimentation secteur (utilitaire) et que le minuteur d’inactivité du système expire.
IdleDc
Structure POWER_ACTION_POLICY qui définit l’action d’alimentation du système à lancer lorsque le système fonctionne sur batterie et que le minuteur d’inactivité du système expire.
IdleTimeoutAc
Durée pendant laquelle le niveau d’activité du système doit rester en dessous du seuil de détection d’inactivité avant que le minuteur d’inactivité système expire lors de l’exécution sur l’alimentation ca (utilitaire), en secondes.
Ce membre est ignoré si le système effectue un CV automatisé, car aucun utilisateur n’est présent. Pour maintenir temporairement le système en cours d’exécution pendant qu’une application exécute une tâche, utilisez la fonction SetThreadExecutionState .
IdleTimeoutDc
Durée pendant laquelle le niveau d’activité du système doit rester inférieur au seuil de détection d’inactivité avant l’expiration du minuteur d’inactivité du système lors de l’exécution sur batterie, en secondes.
Ce membre est ignoré si le système effectue un CV automatisé, car aucun utilisateur n’est présent. Pour maintenir temporairement le système en cours d’exécution pendant qu’une application exécute une tâche, utilisez la fonction SetThreadExecutionState .
IdleSensitivityAc
Niveau d’activité système qui définit le seuil de détection d’inactivité lorsque le système s’exécute sur l’alimentation secteur (utilitaire), exprimé sous forme de pourcentage.
IdleSensitivityDc
Niveau d’activité du système qui définit le seuil de détection d’inactivité lorsque le système fonctionne sur batterie, exprimé en pourcentage.
ThrottlePolicyAc
Stratégie de limitation dynamique du processeur à utiliser lorsque le système s’exécute sur l’alimentation secteur (utilitaire).
ThrottlePolicyDc
Stratégie de limitation dynamique du processeur à utiliser lorsque le système fonctionne sur batterie.
MaxSleepAc
État de mise en veille maximale du système lorsque le système s’exécute sur l’alimentation secteur (utilitaire). Ce membre doit être l’une des valeurs de type d’énumération les SYSTEM_POWER_STATE .
MaxSleepDc
État de veille maximale du système lorsque le système s’exécute sur batterie. Ce membre doit être l’une des valeurs de type d’énumération les SYSTEM_POWER_STATE .
Reserved[2]
Réservé.
VideoTimeoutAc
Temps avant l’affichage désactivé lorsque le système s’exécute sur l’alimentation secteur (utilitaire), en secondes.
VideoTimeoutDc
Temps avant que l’affichage ne soit désactivé lorsque le système fonctionne sur batterie, en secondes.
SpindownTimeoutAc
La durée avant l’alimentation des lecteurs de disque fixe est désactivée lorsque le système s’exécute sur l’alimentation ca (utilitaire), en secondes.
SpindownTimeoutDc
La durée avant l’alimentation des lecteurs de disque fixe est désactivée lorsque le système fonctionne sur batterie, en secondes.
OptimizeForPowerAc
Si ce membre a la valeur TRUE, le système active les ventilateurs de refroidissement et exécute le processeur à pleine vitesse lorsque le refroidissement passif est spécifié et que le système fonctionne sur l’alimentation secteur (utilitaire). Ainsi, le système d’exploitation est orienté vers l’utilisation du ventilateur et l’exécution du processeur à pleine vitesse.
OptimizeForPowerDc
Si ce membre a la valeur TRUE, le système active les ventilateurs de refroidissement et exécute le processeur à pleine vitesse lorsque le refroidissement passif est spécifié et que le système fonctionne sur batterie. Ainsi, le système d’exploitation est orienté vers l’utilisation du ventilateur et l’exécution du processeur à pleine vitesse.
FanThrottleToleranceAc
Limite inférieure à laquelle le processeur peut être limité jusqu’à avant d’allumer les ventilateurs système en réponse à un événement thermique pendant que le système fonctionne sur l’alimentation ca (utilitaire), exprimé sous forme de pourcentage.
FanThrottleToleranceDc
Limite inférieure à laquelle le processeur peut être limité avant d’allumer les ventilateurs système en réponse à un événement thermique pendant que le système fonctionne sur batterie, exprimé en pourcentage.
ForcedThrottleAc
Niveau de limitation du processeur à imposer par le système pendant que l’ordinateur est en cours d’exécution sur l’alimentation ca (utilitaire), exprimé sous forme de pourcentage.
ForcedThrottleDc
Niveau de limitation du processeur à imposer par le système pendant que l’ordinateur fonctionne sur batterie, exprimé sous forme de pourcentage.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| En-tête | powrprof.h |