structure SYSTEM_POWER_POLICY (winnt.h)

Contient des informations sur la stratégie d’alimentation système actuelle.

Syntaxe

typedef struct _SYSTEM_POWER_POLICY {
  DWORD               Revision;
  POWER_ACTION_POLICY PowerButton;
  POWER_ACTION_POLICY SleepButton;
  POWER_ACTION_POLICY LidClose;
  SYSTEM_POWER_STATE  LidOpenWake;
  DWORD               Reserved;
  POWER_ACTION_POLICY Idle;
  DWORD               IdleTimeout;
  BYTE                IdleSensitivity;
  BYTE                DynamicThrottle;
  BYTE                Spare2[2];
  SYSTEM_POWER_STATE  MinSleep;
  SYSTEM_POWER_STATE  MaxSleep;
  SYSTEM_POWER_STATE  ReducedLatencySleep;
  DWORD               WinLogonFlags;
  DWORD               Spare3;
  DWORD               DozeS4Timeout;
  DWORD               BroadcastCapacityResolution;
  SYSTEM_POWER_LEVEL  DischargePolicy[NUM_DISCHARGE_POLICIES];
  DWORD               VideoTimeout;
  BOOLEAN             VideoDimDisplay;
  DWORD               VideoReserved[3];
  DWORD               SpindownTimeout;
  BOOLEAN             OptimizeForPower;
  BYTE                FanThrottleTolerance;
  BYTE                ForcedThrottle;
  BYTE                MinThrottle;
  POWER_ACTION_POLICY OverThrottled;
} SYSTEM_POWER_POLICY, *PSYSTEM_POWER_POLICY;

Membres

Revision

Révision actuelle de la structure.

PowerButton

Une structure POWER_ACTION_POLICY qui définit l’action d’alimentation du système à lancer lorsque le bouton d’alimentation du système est enfoncé.

SleepButton

Structure POWER_ACTION_POLICY qui définit l’action d’alimentation du système à lancer lorsque le bouton de mise en veille du système est enfoncé.

LidClose

Structure POWER_ACTION_POLICY qui définit l’action d’alimentation du système à lancer lorsque le commutateur de couvercle système est fermé.

LidOpenWake

État d’alimentation maximale (valeur Sx la plus élevée) à partir duquel un événement lid-open doit réveiller le système. Ce membre doit être l’une des valeurs de type d’énumération les SYSTEM_POWER_STATE .

Reserved

Réservé.

Idle

Structure POWER_ACTION_POLICY qui définit l’action d’alimentation du système à lancer lorsque le minuteur inactif du système expire.

IdleTimeout

Durée pendant laquelle le niveau d’activité système doit rester inférieur au seuil de détection d’inactivité avant l’expiration du minuteur d’inactivité du système, en secondes.

IdleSensitivity

Niveau d’activité système qui définit le seuil de détection d’inactivité, exprimé sous forme de pourcentage.

DynamicThrottle

Stratégie de limitation dynamique du processeur système actuelle. Ce membre doit être l’une des valeurs décrites dans Constantes de stratégie de contrôle des performances du processeur.

Spare2[2]

Réservé.

MinSleep

État de veille système minimal (valeur Sx la plus faible) actuellement pris en charge. Ce membre doit être l’une des valeurs de type d’énumération les SYSTEM_POWER_STATE .

MaxSleep

État de veille système maximal (valeur Sx la plus élevée) actuellement pris en charge. Ce membre doit être l’une des valeurs de type d’énumération les SYSTEM_POWER_STATE .

ReducedLatencySleep

État d’alimentation du système (valeur Sx) à entrer sur une action de mise en veille du système en cas d’exigences de latence en suspens. Ce membre doit être l’une des valeurs de type d’énumération les SYSTEM_POWER_STATE . Si une application appelle RequestWakeupLatency avec LT_LOWEST_LATENCY, ReducedLatencySleep est utilisé à la place de MaxSleep.

WinLogonFlags

Ce membre peut être égal à zéro ou WINLOGON_LOCK_ON_SLEEP (0x00000001).

Spare3

Réservé.

DozeS4Timeout

Délai d’attente entre l’entrée de l’état de suspension et l’entrée de l’état de veille prolongée, en secondes. La valeur zéro indique qu’il n’est jamais mis en veille prolongée.

BroadcastCapacityResolution

Résolution de la modification de la capacité actuelle de la batterie qui doit entraîner la notification d’un événement de modification de l’état d’alimentation du système.

DischargePolicy[NUM_DISCHARGE_POLICIES]

Tableau de structures SYSTEM_POWER_LEVEL qui définit les actions à entreprendre lors des événements de décharge de la batterie du système.

VideoTimeout

Délai avant la désactivation de l’affichage, en secondes.

VideoDimDisplay

Si ce membre a la valeur TRUE, le système prend en charge la gradation de l’affichage.

VideoReserved[3]

Réservé.

SpindownTimeout

La durée avant l’alimentation des lecteurs de disque fixe est désactivée, en secondes.

OptimizeForPower

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é. Ainsi, le système d’exploitation est orienté vers l’utilisation du ventilateur et l’exécution du processeur à pleine vitesse.

FanThrottleTolerance

Limite inférieure à laquelle le processeur peut être limité avant d’allumer les ventilateurs système en réponse à un événement thermique, exprimée en pourcentage.

ForcedThrottle

Niveau de limitation du processeur à imposer par le système, exprimé en pourcentage.

MinThrottle

Niveau de limitation minimal du processeur, exprimé en pourcentage.

OverThrottled

Structure POWER_ACTION_POLICY qui définit l’action d’alimentation du système à lancer en réponse à un événement thermique lorsque la limitation du processeur ne peut pas réduire de manière adéquate la température du système.

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	winnt.h (inclure Windows.h)

Voir aussi

CallNtPowerInformation

POWER_ACTION_POLICY

SYSTEM_POWER_LEVEL