struktur MACHINE_POWER_POLICY (powrprof.h)

Artikel
2024-03-04

Berisi setelan kebijakan daya komputer yang unik untuk setiap skema daya pada komputer. Struktur ini adalah bagian dari struktur POWER_POLICY .

Sintaks

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;

Anggota

Revision

Tingkat revisi struktur saat ini. Atur nilai ini dengan memanggil GetCurrentPowerPolicies atau ReadPwrScheme sebelum menggunakan struktur MACHINE_POWER_POLICY untuk menetapkan kebijakan daya.

MinSleepAc

Status daya sistem minimum (nilai Sx terendah) untuk dimasukkan pada tindakan tidur sistem saat berjalan pada daya AC. Anggota ini harus menjadi salah satu nilai jenis enumerasi SYSTEM_POWER_STATE .

MinSleepDc

Status daya sistem minimum (nilai Sx terendah) untuk dimasukkan pada tindakan tidur sistem saat berjalan pada daya baterai. Anggota ini harus menjadi salah satu nilai jenis enumerasi SYSTEM_POWER_STATE .

ReducedLatencySleepAc

Status daya sistem maksimum (nilai Sx tertinggi) untuk dimasukkan pada tindakan tidur sistem saat berjalan pada daya AC, dan ketika ada persyaratan latensi yang luar biasa. Anggota ini harus menjadi salah satu nilai jenis enumerasi SYSTEM_POWER_STATE . Jika aplikasi memanggil RequestWakeupLatency dengan LT_LOWEST_LATENCY, ReducedLatencySleepAc digunakan sebagai pengganti MaxSleepAc.

ReducedLatencySleepDc

Status daya sistem maksimum (nilai Sx tertinggi) untuk dimasukkan pada tindakan tidur sistem saat berjalan pada daya baterai, dan ketika ada persyaratan latensi yang luar biasa. Anggota ini harus menjadi salah satu nilai jenis enumerasi SYSTEM_POWER_STATE . Jika aplikasi memanggil RequestWakeupLatency dengan LT_LOWEST_LATENCY, ReducedLatencySleepAc digunakan sebagai pengganti MaxSleepAc.

DozeTimeoutAc

Anggota ini diabaikan.

DozeTimeoutDc

Anggota ini diabaikan.

DozeS4TimeoutAc

Waktu untuk menunggu antara memasuki status ditangguhkan dan memasuki status tidur hibernasi ketika sistem berjalan pada daya AC, dalam hitungan detik. Nilai nol menunjukkan tidak pernah hibernasi.

DozeS4TimeoutDc

Waktu untuk menunggu antara memasuki status suspensi dan memasuki keadaan tidur hibernasi ketika sistem berjalan pada daya baterai, dalam hitungan detik. Nilai nol menunjukkan tidak pernah hibernasi.

MinThrottleAc

Pengaturan pembatasan minimum yang diizinkan sebelum ditimpa ketika sistem berjalan pada daya AC. Kondisi termal akan menjadi satu-satunya alasan untuk berada di bawah pengaturan minimum. Ketika prosesor ditimpa, sistem akan memulai kebijakan OverThrottledAc . Perhatikan bahwa manajer kebijakan daya memiliki kebijakan yang dikodekan secara permanen untuk memulai CriticalShutdownOff setiap kali zona termal menunjukkan kondisi termal yang kritis. Rentang: 0-100.

MinThrottleDc

Pengaturan pembatasan minimum yang diizinkan sebelum overthrottle ketika sistem berjalan pada daya baterai. Kondisi termal akan menjadi satu-satunya alasan untuk berada di bawah pengaturan minimum. Ketika prosesor ditimpa, sistem akan memulai kebijakan OverThrottledDc . Perhatikan bahwa manajer kebijakan daya memiliki kebijakan yang dikodekan secara permanen untuk memulai CriticalShutdownOff setiap kali zona termal menunjukkan kondisi termal yang kritis. Rentang: 0-100.

pad1[2]

Dicadangkan.

OverThrottledAc

Struktur POWER_ACTION_POLICY yang menentukan tindakan yang harus diambil ketika prosesor telah ditimpa (seperti yang didefinisikan oleh anggota MinThrottleAc ) ketika sistem berjalan pada daya AC.

OverThrottledDc

Struktur POWER_ACTION_POLICY yang menentukan tindakan yang harus diambil ketika prosesor telah ditimpa (seperti yang didefinisikan oleh anggota MinThrottleDc ) ketika sistem berjalan pada daya baterai.

Keterangan

DozeS4TimeoutAc dan DozeS4TimeoutDc sesuai dengan anggota DozeS4Timeoutdari SYSTEM_POWER_POLICY. Nilai-nilai ini digabungkan dari kebijakan daya mesin ke kebijakan daya sistem ketika fungsi SetActivePwrScheme dipanggil untuk menerapkan skema daya.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	powrprof.h

Lihat juga

POWER_ACTION_POLICY

POWER_POLICY

Bagikan melalui