struktur USER_POWER_POLICY (powrprof.h)

Artikel
08/25/2023

Berisi pengaturan kebijakan daya yang unik untuk setiap skema daya untuk pengguna. Struktur ini adalah bagian dari struktur POWER_POLICY .

Sintaks

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;

Anggota

Revision

Tingkat revisi struktur saat ini. Tetapkan nilai ini dengan memanggil GetCurrentPowerPolicies atau ReadPwrScheme sebelum menggunakan struktur USER_POWER_POLICY untuk mengatur kebijakan daya.

IdleAc

Struktur POWER_ACTION_POLICY yang mendefinisikan tindakan daya sistem untuk memulai ketika sistem berjalan pada daya AC (utilitas) dan timer menganggur sistem kedaluwarsa.

IdleDc

Struktur POWER_ACTION_POLICY yang mendefinisikan tindakan daya sistem untuk memulai ketika sistem berjalan pada daya baterai dan timer menganggur sistem kedaluwarsa.

IdleTimeoutAc

Waktu tingkat aktivitas sistem harus tetap berada di bawah ambang deteksi diam sebelum timer diam sistem kedaluwarsa saat berjalan pada daya AC (utilitas), dalam hitungan detik.

Anggota ini diabaikan jika sistem melakukan resume otomatis karena tidak ada pengguna. Untuk sementara menjaga sistem tetap berjalan saat aplikasi melakukan tugas, gunakan fungsi SetThreadExecutionState .

IdleTimeoutDc

Waktu tingkat aktivitas sistem harus tetap berada di bawah ambang deteksi diam sebelum timer diam sistem kedaluwarsa saat berjalan pada daya baterai, dalam hitungan detik.

IdleSensitivityAc

Tingkat aktivitas sistem yang menentukan ambang batas untuk deteksi diam ketika sistem berjalan pada daya AC (utilitas), dinyatakan sebagai persentase.

IdleSensitivityDc

Tingkat aktivitas sistem yang menentukan ambang batas untuk deteksi diam ketika sistem berjalan pada daya baterai, dinyatakan sebagai persentase.

ThrottlePolicyAc

Kebijakan pembatasan dinamis prosesor untuk digunakan ketika sistem berjalan pada daya AC (utilitas).

ThrottlePolicyDc

Kebijakan pembatasan dinamis prosesor untuk digunakan ketika sistem berjalan pada daya baterai.

MaxSleepAc

Status tidur sistem maksimum ketika sistem berjalan pada daya AC (utilitas). Anggota ini harus menjadi salah satu nilai jenis enumerasi SYSTEM_POWER_STATE .

MaxSleepDc

Status tidur sistem maksimum ketika sistem berjalan dengan daya baterai. Anggota ini harus menjadi salah satu nilai jenis enumerasi SYSTEM_POWER_STATE .

Reserved[2]

Dicadangkan.

VideoTimeoutAc

Waktu sebelum layar dimatikan saat sistem berjalan pada daya AC (utilitas), dalam hitung detik.

VideoTimeoutDc

Waktu sebelum layar dimatikan saat sistem berjalan dengan daya baterai, dalam hitung detik.

SpindownTimeoutAc

Waktu sebelum daya ke drive disk tetap dimatikan ketika sistem berjalan pada daya AC (utilitas), dalam hitung detik.

SpindownTimeoutDc

Waktu sebelum daya ke drive disk tetap dimatikan ketika sistem berjalan pada daya baterai, dalam hitung detik.

OptimizeForPowerAc

Jika anggota ini TRUE, sistem akan menyalakan kipas pendingin dan menjalankan prosesor dengan kecepatan penuh ketika pendinginan pasif ditentukan dan sistem berjalan pada daya AC (utilitas). Hal ini menyebabkan sistem operasi bias terhadap penggunaan kipas angin dan menjalankan prosesor dengan kecepatan penuh.

OptimizeForPowerDc

Jika anggota ini BENAR, sistem akan menyalakan kipas pendingin dan menjalankan prosesor dengan kecepatan penuh ketika pendinginan pasif ditentukan dan sistem berjalan pada daya baterai. Hal ini menyebabkan sistem operasi bias terhadap penggunaan kipas angin dan menjalankan prosesor dengan kecepatan penuh.

FanThrottleToleranceAc

Batas bawah prosesor dapat dibatasi hingga sebelum menyalakan kipas sistem sebagai respons terhadap peristiwa termal saat sistem beroperasi pada daya AC (utilitas), dinyatakan sebagai persentase.

FanThrottleToleranceDc

Batas bawah prosesor dapat dibatasi hingga sebelum menyalakan kipas sistem sebagai respons terhadap peristiwa termal saat sistem beroperasi pada daya baterai, dinyatakan sebagai persentase.

ForcedThrottleAc

Tingkat pembatasan prosesor yang akan diberlakukan oleh sistem saat komputer berjalan pada daya AC (utilitas), dinyatakan sebagai persentase.

ForcedThrottleDc

Tingkat pembatasan prosesor yang akan diberlakukan oleh sistem saat komputer berjalan dengan daya baterai, dinyatakan sebagai persentase.

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

Share via