Condividi tramite


MACHINE_POWER_POLICY struttura (powrprof.h)

Contiene le impostazioni dei criteri di alimentazione del computer univoche per ogni schema di alimentazione nel computer. Questa struttura fa parte della struttura POWER_POLICY .

Sintassi

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;

Members

Revision

Livello di revisione della struttura corrente. Impostare questo valore chiamando GetCurrentPowerPolicies o ReadPwrScheme prima di usare una struttura MACHINE_POWER_POLICY per impostare i criteri di alimentazione.

MinSleepAc

Lo stato minimo di alimentazione del sistema (valore Sx più basso) da immettere su un'azione di sospensione del sistema durante l'esecuzione sull'alimentazione AC. Questo membro deve essere uno dei valori di tipo di enumerazione SYSTEM_POWER_STATE .

MinSleepDc

Lo stato minimo di alimentazione del sistema (valore Sx minimo) da immettere su un'azione di sospensione del sistema durante l'esecuzione della batteria. Questo membro deve essere uno dei valori di tipo di enumerazione SYSTEM_POWER_STATE .

ReducedLatencySleepAc

Lo stato massimo di alimentazione del sistema (valore Sx più alto) per immettere un'azione di sospensione del sistema durante l'esecuzione sull'alimentazione AC e quando sono presenti requisiti di latenza in sospeso. Questo membro deve essere uno dei valori di tipo di enumerazione SYSTEM_POWER_STATE . Se un'applicazione chiama RequestWakeupLatency con LT_LOWEST_LATENCY, ReducedLatencySleepAc viene usato al posto di MaxSleepAc.

ReducedLatencySleepDc

Lo stato massimo di alimentazione del sistema (valore Sx più alto) da immettere su un'azione di sospensione del sistema durante l'esecuzione sulla batteria e quando sono presenti requisiti di latenza in sospeso. Questo membro deve essere uno dei valori di tipo di enumerazione SYSTEM_POWER_STATE . Se un'applicazione chiama RequestWakeupLatency con LT_LOWEST_LATENCY, ReducedLatencySleepAc viene usato al posto di MaxSleepAc.

DozeTimeoutAc

Questo membro viene ignorato.

DozeTimeoutDc

Questo membro viene ignorato.

DozeS4TimeoutAc

Tempo di attesa tra l'immissione dello stato di sospensione e l'immissione dello stato di sospensione di ibernazione quando il sistema è in esecuzione sull'alimentazione AC, in secondi. Un valore pari a zero indica mai l'ibernazione.

DozeS4TimeoutDc

Tempo di attesa tra l'immissione dello stato di sospensione e l'immissione dello stato di sospensione quando il sistema è in esecuzione sulla potenza della batteria, in secondi. Un valore pari a zero indica mai l'ibernazione.

MinThrottleAc

Impostazione minima della limitazione consentita prima di essere sovrathrottled quando il sistema è in esecuzione sull'alimentazione AC. Le condizioni termiche sarebbero l'unico motivo per andare al di sotto dell'impostazione minima. Quando il processore è sovrathrottled, il sistema avvierà il criterio OverThrottledAc . Si noti che il gestore di power policy ha un criterio hard coded per avviare un'entità CriticalShutdownOff ogni volta che qualsiasi zona termica indica una condizione termica critica. Intervallo: 0-100.

MinThrottleDc

Impostazione minima della limitazione consentita prima di essere sovrathrottled quando il sistema è in esecuzione sulla batteria. Le condizioni termiche sarebbero l'unico motivo per andare al di sotto dell'impostazione minima. Quando il processore è sovrathrottled, il sistema avvierà il criterio OverThrottledDc . Si noti che il gestore di power policy ha un criterio hard coded per avviare un'entità CriticalShutdownOff ogni volta che qualsiasi zona termica indica una condizione termica critica. Intervallo: 0-100.

pad1[2]

Riservato.

OverThrottledAc

Una struttura POWER_ACTION_POLICY che definisce l'azione da eseguire quando un processore è diventato sovrathrottled (come definito dal membro MinThrottleAc ) quando il sistema è in esecuzione sull'alimentazione AC.

OverThrottledDc

Una struttura POWER_ACTION_POLICY che definisce l'azione da eseguire quando un processore è diventato sovrathrottled (come definito dal membro MinThrottleDc ) quando il sistema è in esecuzione sulla potenza della batteria.

Commenti

DozeS4TimeoutAc e DozeS4TimeoutDc corrispondono al membro DozeS4Timeout di SYSTEM_POWER_POLICY. Questi valori vengono uniti dai criteri di alimentazione del computer ai criteri di alimentazione del sistema quando viene chiamata la funzione SetActivePwrScheme per applicare uno schema di alimentazione.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Intestazione powrprof.h

Vedi anche

POWER_ACTION_POLICY

POWER_POLICY