structure MACHINE_POWER_POLICY (powrprof.h)
Contient les paramètres de stratégie d’alimentation de l’ordinateur qui sont propres à chaque schéma d’alimentation sur l’ordinateur. Cette structure fait partie de la structure POWER_POLICY .
Syntaxe
typedef struct _MACHINE_POWER_POLICY {
ULONG Revision;
SYSTEM_POWER_STATE MinSleepAc;
SYSTEM_POWER_STATE MinSleepDc;
SYSTEM_POWER_STATE ReducedLatencySleepAc;
SYSTEM_POWER_STATE ReducedLatencySleepDc;
ULONG DozeTimeoutAc;
ULONG DozeTimeoutDc;
ULONG DozeS4TimeoutAc;
ULONG DozeS4TimeoutDc;
UCHAR MinThrottleAc;
UCHAR MinThrottleDc;
UCHAR pad1[2];
POWER_ACTION_POLICY OverThrottledAc;
POWER_ACTION_POLICY OverThrottledDc;
} MACHINE_POWER_POLICY, *PMACHINE_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 MACHINE_POWER_POLICY pour définir une stratégie d’alimentation.
MinSleepAc
État d’alimentation système minimal (valeur Sx la plus faible) à entrer sur une action de mise en veille du système lors de l’exécution sur l’alimentation secteur. Ce membre doit être l’une des valeurs de type d’énumération les SYSTEM_POWER_STATE .
MinSleepDc
État d’alimentation minimale du système (valeur Sx la plus faible) à entrer sur une action de mise en veille du système lors de l’exécution sur batterie. Ce membre doit être l’une des valeurs de type d’énumération les SYSTEM_POWER_STATE .
ReducedLatencySleepAc
État d’alimentation du système maximal (valeur Sx la plus élevée) à entrer sur une action de mise en veille du système lors de l’exécution sur l’alimentation secteur et en cas de latence restante requise. 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, ReducedLatencySleepAc est utilisé à la place de MaxSleepAc.
ReducedLatencySleepDc
État d’alimentation du système maximal (valeur Sx la plus élevée) à entrer sur une action de mise en veille du système lors de l’exécution sur batterie et lorsque des exigences de latence sont 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, ReducedLatencySleepAc est utilisé à la place de MaxSleepAc.
DozeTimeoutAc
Ce membre est ignoré.
DozeTimeoutDc
Ce membre est ignoré.
DozeS4TimeoutAc
Temps d’attente entre l’entrée de l’état de suspension et l’entrée de l’état de veille prolongée lorsque le système s’exécute sur l’alimentation secteur, en quelques secondes. La valeur zéro indique qu’il n’est jamais mis en veille prolongée.
DozeS4TimeoutDc
Temps d’attente entre l’entrée de l’état de suspension et l’entrée de l’état de veille prolongée lorsque le système fonctionne sur batterie, en secondes. La valeur zéro indique qu’il n’est jamais mis en veille prolongée.
MinThrottleAc
Paramètre de limitation minimal autorisé avant d’être surtrotté lorsque le système s’exécute sur l’alimentation secteur. Les conditions thermiques seraient la seule raison pour passer en dessous de la valeur minimale. Lorsque le processeur est surthrotté, le système lance la stratégie OverThrottledAc . Notez que le gestionnaire de stratégie d’alimentation a une stratégie codée en dur pour lancer un CriticalShutdownOff chaque fois qu’une zone thermique indique une condition thermique critique. Plage : 0-100.
MinThrottleDc
Paramètre de limitation minimal autorisé avant d’être surthrotté lorsque le système fonctionne sur batterie. Les conditions thermiques seraient la seule raison pour passer en dessous de la valeur minimale. Lorsque le processeur est surthrotté, le système lance la stratégie OverThrottledDc . Notez que le gestionnaire de stratégie d’alimentation a une stratégie codée en dur pour lancer un CriticalShutdownOff chaque fois qu’une zone thermique indique une condition thermique critique. Plage : 0-100.
pad1[2]
Réservé.
OverThrottledAc
Une structure de POWER_ACTION_POLICY qui définit l’action à entreprendre lorsqu’un processeur est dépassé (tel que défini par le membre MinThrottleAc ) lorsque le système s’exécute sur l’alimentation secteur.
OverThrottledDc
Une structure POWER_ACTION_POLICY qui définit l’action à entreprendre lorsqu’un processeur est dépassé (tel que défini par le membre MinThrottleDc ) lorsque le système fonctionne sur batterie.
Remarques
DozeS4TimeoutAc et DozeS4TimeoutDc correspondent au membre DozeS4Timeout de SYSTEM_POWER_POLICY. Ces valeurs sont fusionnées de la stratégie d’alimentation de la machine à la stratégie d’alimentation du système lorsque la fonction SetActivePwrScheme est appelée pour appliquer un schéma d’alimentation.
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 |