USER_POWER_POLICY struttura (powrprof.h)

Articolo
03/13/2024

Contiene le impostazioni dei criteri di alimentazione univoche per ogni schema di alimentazione per un utente. Questa struttura fa parte della struttura POWER_POLICY .

Sintassi

typedef struct _USER_POWER_POLICY {
  ULONG               Revision;
  POWER_ACTION_POLICY IdleAc;
  POWER_ACTION_POLICY IdleDc;
  ULONG               IdleTimeoutAc;
  ULONG               IdleTimeoutDc;
  UCHAR               IdleSensitivityAc;
  UCHAR               IdleSensitivityDc;
  UCHAR               ThrottlePolicyAc;
  UCHAR               ThrottlePolicyDc;
  SYSTEM_POWER_STATE  MaxSleepAc;
  SYSTEM_POWER_STATE  MaxSleepDc;
  ULONG               Reserved[2];
  ULONG               VideoTimeoutAc;
  ULONG               VideoTimeoutDc;
  ULONG               SpindownTimeoutAc;
  ULONG               SpindownTimeoutDc;
  BOOLEAN             OptimizeForPowerAc;
  BOOLEAN             OptimizeForPowerDc;
  UCHAR               FanThrottleToleranceAc;
  UCHAR               FanThrottleToleranceDc;
  UCHAR               ForcedThrottleAc;
  UCHAR               ForcedThrottleDc;
} USER_POWER_POLICY, *PUSER_POWER_POLICY;

Members

Revision

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

IdleAc

Struttura POWER_ACTION_POLICY che definisce l'azione di alimentazione del sistema da avviare quando il sistema è in esecuzione sulla potenza ac (utilità) e il timer di inattività del sistema scade.

IdleDc

Struttura POWER_ACTION_POLICY che definisce l'azione di alimentazione del sistema da avviare quando il sistema è in esecuzione sulla batteria e il timer di inattività del sistema scade.

IdleTimeoutAc

L'ora in cui il livello di attività di sistema deve rimanere al di sotto della soglia di rilevamento inattiva prima della scadenza del timer di inattività del sistema quando viene eseguita l'alimentazione ac (utilità), in secondi.

Questo membro viene ignorato se il sistema esegue una ripresa automatica perché non è presente alcun utente. Per mantenere temporaneamente in esecuzione il sistema mentre un'applicazione esegue un'attività, usare la funzione SetThreadExecutionState .

IdleTimeoutDc

Il tempo in cui il livello di attività del sistema deve rimanere al di sotto della soglia di rilevamento inattiva prima della scadenza del timer di inattività del sistema quando si esegue l'alimentazione della batteria, in secondi.

IdleSensitivityAc

Livello di attività di sistema che definisce la soglia per il rilevamento inattiva quando il sistema è in esecuzione sulla potenza ac (utilità), espressa come percentuale.

IdleSensitivityDc

Livello di attività di sistema che definisce la soglia per il rilevamento inattiva quando il sistema è in esecuzione sulla potenza della batteria, espresso come percentuale.

ThrottlePolicyAc

I criteri di limitazione dinamica del processore da usare quando il sistema è in esecuzione sulla potenza dell'utilità (AC).

ThrottlePolicyDc

I criteri di limitazione dinamica del processore da usare quando il sistema è in esecuzione sulla potenza della batteria.

MaxSleepAc

Stato di sospensione del sistema massimo quando il sistema è in esecuzione sulla potenza dell'interfaccia di rete (utilità). Questo membro deve essere uno dei valori di tipo di enumerazione SYSTEM_POWER_STATE .

MaxSleepDc

Stato di sospensione del sistema massimo quando il sistema è in esecuzione sulla batteria. Questo membro deve essere uno dei valori di tipo di enumerazione SYSTEM_POWER_STATE .

Reserved[2]

Riservato.

VideoTimeoutAc

L'ora prima che la visualizzazione venga disattivata quando il sistema è in esecuzione sull'alimentazione ac (utilità), in secondi.

VideoTimeoutDc

Il tempo prima che il display venga disattivato quando il sistema è in esecuzione sulla potenza della batteria, in secondi.

SpindownTimeoutAc

Il tempo prima dell'alimentazione delle unità disco fisse viene disattivato quando il sistema è in esecuzione sull'alimentazione ac (utilità), in secondi.

SpindownTimeoutDc

Il tempo prima dell'alimentazione delle unità disco fisse viene disattivato quando il sistema è in esecuzione sulla potenza della batteria, in secondi.

OptimizeForPowerAc

Se questo membro è TRUE, il sistema attiverà i fan di raffreddamento ed eseguirà il processore a velocità completa quando viene specificato il raffreddamento passivo e il sistema è in esecuzione sulla potenza ac (utilità). In questo modo il sistema operativo deve essere pregiudiziato verso l'uso della ventola e l'esecuzione del processore a velocità completa.

OptimizeForPowerDc

Se questo membro è TRUE, il sistema attiva ventole di raffreddamento ed esegue il processore a velocità completa quando viene specificato il raffreddamento passivo e il sistema è in esecuzione sulla potenza della batteria. In questo modo il sistema operativo deve essere pregiudiziato verso l'uso della ventola e l'esecuzione del processore a velocità completa.

FanThrottleToleranceAc

Limite inferiore a cui il processore può essere limitato prima di attivare i fan del sistema in risposta a un evento termica mentre il sistema opera sulla potenza ac (utilità) espressa come percentuale.

FanThrottleToleranceDc

Il limite inferiore che il processore può essere limitato a prima di attivare i fan del sistema in risposta a un evento termica mentre il sistema opera sulla potenza della batteria, espresso come percentuale.

ForcedThrottleAc

Il livello di limitazione del processore da imporre al sistema mentre il computer è in esecuzione sulla potenza ac (utilità), espressa come percentuale.

ForcedThrottleDc

Il livello di limitazione del processore da imporre al sistema mentre il computer è in esecuzione sulla batteria, espresso come percentuale.

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

Condividi tramite