estructura MACHINE_POWER_POLICY (powrprof.h)

Contiene la configuración de directiva de energía del equipo que son únicas para cada esquema de energía del equipo. Esta estructura forma parte de la estructura POWER_POLICY .

Sintaxis

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;

Miembros

Revision

Nivel de revisión de la estructura actual. Establezca este valor llamando a GetCurrentPowerPolicies o ReadPwrScheme antes de usar una estructura de MACHINE_POWER_POLICY para establecer la directiva de energía.

MinSleepAc

Estado mínimo de energía del sistema (valor Sx más bajo) para entrar en una acción de suspensión del sistema cuando se ejecuta en la alimentación de CA. Este miembro debe ser uno de los SYSTEM_POWER_STATE valores de tipo de enumeración.

MinSleepDc

El estado mínimo de energía del sistema (valor Sx más bajo) para entrar en una acción de suspensión del sistema cuando se ejecuta en la energía de la batería. Este miembro debe ser uno de los SYSTEM_POWER_STATE valores de tipo de enumeración.

ReducedLatencySleepAc

Estado máximo de energía del sistema (valor Sx más alto) para entrar en una acción de suspensión del sistema cuando se ejecuta en la alimentación de CA y cuando hay requisitos de latencia pendientes. Este miembro debe ser uno de los SYSTEM_POWER_STATE valores de tipo de enumeración. Si una aplicación llama a RequestWakeupLatency con LT_LOWEST_LATENCY, se usa ReducedLatencySleepAc en lugar de MaxSleepAc.

ReducedLatencySleepDc

El estado máximo de energía del sistema (valor Sx más alto) para entrar en una acción de suspensión del sistema cuando se ejecuta en la batería y cuando hay requisitos de latencia pendientes. Este miembro debe ser uno de los SYSTEM_POWER_STATE valores de tipo de enumeración. Si una aplicación llama a RequestWakeupLatency con LT_LOWEST_LATENCY, se usa ReducedLatencySleepAc en lugar de MaxSleepAc.

DozeTimeoutAc

Este miembro se omite.

DozeTimeoutDc

Este miembro se omite.

DozeS4TimeoutAc

Tiempo de espera entre entrar en el estado de suspensión y entrar en el estado de suspensión hibernar cuando el sistema se ejecuta en la alimentación de CA, en segundos. Un valor de cero indica que nunca hiberna.

DozeS4TimeoutDc

Tiempo de espera entre entrar en el estado de suspensión y entrar en el estado de suspensión hibernar cuando el sistema se está ejecutando en la energía de la batería, en segundos. Un valor de cero indica que nunca hiberna.

MinThrottleAc

La configuración de limitación mínima permitida antes de ser sobrecargada cuando el sistema se ejecuta en la alimentación de CA. Las condiciones térmicas serían la única razón para ir por debajo del ajuste mínimo. Cuando el procesador está sobrecargado, el sistema iniciará la directiva OverThrottledAc . Tenga en cuenta que el administrador de directivas de energía tiene una directiva codificada de forma rígida para iniciar criticalShutdownOff siempre que cualquier zona térmica indique una condición térmica crítica. Intervalo: 0-100.

MinThrottleDc

La configuración mínima de limitación permitida antes de ser sobrecargada cuando el sistema se está ejecutando en la batería. Las condiciones térmicas serían la única razón para ir por debajo del ajuste mínimo. Cuando el procesador está sobrecargado, el sistema iniciará la directiva OverThrottledDc . Tenga en cuenta que el administrador de directivas de energía tiene una directiva codificada de forma rígida para iniciar criticalShutdownOff siempre que cualquier zona térmica indique una condición térmica crítica. Intervalo: 0-100.

pad1[2]

Reservado.

OverThrottledAc

Estructura POWER_ACTION_POLICY que define la acción que se debe realizar cuando un procesador se ha sobrecargado (según lo definido por el miembro MinThrottleAc ) cuando el sistema se está ejecutando en la alimentación de CA.

OverThrottledDc

Estructura de POWER_ACTION_POLICY que define la acción que se debe realizar cuando un procesador se ha sobreaplicado (según lo definido por el miembro MinThrottleDc ) cuando el sistema se está ejecutando con batería.

Comentarios

DozeS4TimeoutAc y DozeS4TimeoutDc corresponden al miembro DozeS4Timeout de SYSTEM_POWER_POLICY. Estos valores se combinan desde la directiva de energía de la máquina a la directiva de energía del sistema cuando se llama a la función SetActivePwrScheme para aplicar un esquema de energía.

Requisitos

Consulte también

POWER_ACTION_POLICY

POWER_POLICY