Partager via


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

Voir aussi

POWER_ACTION_POLICY

POWER_POLICY