struktur SYSTEM_POWER_CAPABILITIES (winnt.h)

Artikel
03/04/2024

Berisi informasi tentang kemampuan daya sistem.

Sintaks

typedef struct {
  BOOLEAN                 PowerButtonPresent;
  BOOLEAN                 SleepButtonPresent;
  BOOLEAN                 LidPresent;
  BOOLEAN                 SystemS1;
  BOOLEAN                 SystemS2;
  BOOLEAN                 SystemS3;
  BOOLEAN                 SystemS4;
  BOOLEAN                 SystemS5;
  BOOLEAN                 HiberFilePresent;
  BOOLEAN                 FullWake;
  BOOLEAN                 VideoDimPresent;
  BOOLEAN                 ApmPresent;
  BOOLEAN                 UpsPresent;
  BOOLEAN                 ThermalControl;
  BOOLEAN                 ProcessorThrottle;
  BYTE                    ProcessorMinThrottle;
  BYTE                    ProcessorThrottleScale;
  BYTE                    spare2[4];
  BYTE                    ProcessorMaxThrottle;
  BOOLEAN                 FastSystemS4;
  BOOLEAN                 Hiberboot;
  BOOLEAN                 WakeAlarmPresent;
  BOOLEAN                 AoAc;
  BOOLEAN                 DiskSpinDown;
#if ...
  BYTE                    spare3[8];
  BYTE                    HiberFileType;
  BOOLEAN                 AoAcConnectivitySupported;
#else
  BYTE                    spare3[6];
#endif
  BOOLEAN                 SystemBatteriesPresent;
  BOOLEAN                 BatteriesAreShortTerm;
  BATTERY_REPORTING_SCALE BatteryScale[3];
  SYSTEM_POWER_STATE      AcOnLineWake;
  SYSTEM_POWER_STATE      SoftLidWake;
  SYSTEM_POWER_STATE      RtcWake;
  SYSTEM_POWER_STATE      MinDeviceWakeState;
  SYSTEM_POWER_STATE      DefaultLowLatencyWake;
} SYSTEM_POWER_CAPABILITIES, *PSYSTEM_POWER_CAPABILITIES;

Anggota

PowerButtonPresent

Jika anggota ini TRUE, ada tombol daya sistem.

SleepButtonPresent

Jika anggota ini TRUE, ada tombol tidur sistem.

LidPresent

Jika anggota ini TRUE, ada sakelar tutup.

SystemS1

Jika anggota ini TRUE, sistem operasi mendukung status tidur S1.

SystemS2

Jika anggota ini TRUE, sistem operasi mendukung status tidur S2.

SystemS3

Jika anggota ini TRUE, sistem operasi mendukung status tidur S3.

SystemS4

Jika anggota ini TRUE, sistem operasi mendukung status tidur S4 (hibernasi).

SystemS5

Jika anggota ini TRUE, sistem operasi mendukung matikan status S5 (soft off).

HiberFilePresent

Jika anggota ini TRUE, file hibernasi sistem ada.

FullWake

Jika anggota ini TRUE, sistem mendukung kemampuan bangun.

VideoDimPresent

Jika anggota ini TRUE, sistem mendukung kemampuan peredupan tampilan video.

ApmPresent

Jika anggota ini TRUE, sistem mendukung fitur manajemen daya APM BIOS.

UpsPresent

Jika anggota ini TRUE, ada catu daya yang tidak dapat diganggu (UPS).

ThermalControl

Jika anggota ini TRUE, sistem mendukung zona termal.

ProcessorThrottle

Jika anggota ini TRUE, sistem mendukung pembatasan prosesor.

ProcessorMinThrottle

Tingkat minimum pembatasan prosesor sistem yang didukung, dinyatakan sebagai persentase.

ProcessorThrottleScale

spare2[4]

ProcessorMaxThrottle

Tingkat maksimum pembatasan prosesor sistem yang didukung, dinyatakan sebagai persentase.

FastSystemS4

Jika anggota ini TRUE, sistem mendukung status tidur hibrid.

Hiberboot

WakeAlarmPresent

Jika anggota ini TRUE, platform memiliki dukungan untuk perangkat alarm bangun ACPI. Untuk detail selengkapnya tentang perangkat alarm bangun, silakan lihat bagian spesifikasi ACPI 9.18.

AoAc

Jika anggota ini TRUE, sistem mendukung model idle daya rendah S0.

DiskSpinDown

Jika anggota ini TRUE, sistem mendukung penghapusan daya ke perangkat disk tetap.

spare3[8]

Dicadangkan.

HiberFileType

AoAcConnectivitySupported

spare3[6]

Dicadangkan.

SystemBatteriesPresent

Jika anggota ini BENAR, ada satu atau beberapa baterai dalam sistem.

BatteriesAreShortTerm

Jika anggota ini BENAR, baterai sistem bersifat jangka pendek. Baterai jangka pendek digunakan dalam pasokan listrik (UPS) yang tidak dapat diganggu.

BatteryScale[3]

Struktur BATTERY_REPORTING_SCALE yang berisi informasi tentang bagaimana metrik baterai sistem dilaporkan.

AcOnLineWake

Status tidur sistem (Sx) terendah yang akan menghasilkan peristiwa bangun ketika sistem berada di daya AC. Anggota ini harus menjadi salah satu nilai jenis enumerasi SYSTEM_POWER_STATE .

SoftLidWake

Status tidur sistem (Sx) terendah yang akan menghasilkan peristiwa bangun melalui sakelar tutup. Anggota ini harus menjadi salah satu nilai jenis enumerasi SYSTEM_POWER_STATE .

RtcWake

Status tidur sistem (Sx) terendah yang didukung oleh perangkat keras yang akan menghasilkan peristiwa bangun melalui Jam Real Time (RTC). Anggota ini harus menjadi salah satu nilai jenis enumerasi SYSTEM_POWER_STATE .

Untuk membangunkan komputer menggunakan RTC, sistem operasi juga harus mendukung bangun dari status tidur komputer ketika RTC menghasilkan peristiwa bangun. Oleh karena itu, status tidur terendah yang efektif dari mana peristiwa bangun RTC dapat membangunkan komputer adalah status tidur terendah yang didukung oleh sistem operasi yang sama dengan atau lebih tinggi dari nilai RtcWake. Untuk menentukan status tidur yang didukung sistem operasi, periksa anggota SystemS1, SystemS2, SystemS3, dan SystemS4 .

MinDeviceWakeState

Status daya sistem minimum yang diizinkan yang mendukung peristiwa bangun. Anggota ini harus menjadi salah satu nilai jenis enumerasi SYSTEM_POWER_STATE . Perhatikan bahwa status ini dapat berubah karena driver perangkat yang berbeda diinstal pada sistem.

DefaultLowLatencyWake

Status daya sistem default yang digunakan jika aplikasi memanggil RequestWakeupLatency dengan LT_LOWEST_LATENCY. Anggota ini harus menjadi salah satu nilai jenis enumerasi SYSTEM_POWER_STATE .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	winnt.h (sertakan Windows.h)

Lihat juga

CallNtPowerInformation

Status Daya Sistem

Bagikan melalui