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

Voir aussi

POWER_ACTION_POLICY

POWER_POLICY