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) |