структура SYSTEM_POWER_CAPABILITIES (winnt.h)

Статья
03/08/2023

Содержит сведения о возможностях системы управления питанием.

Синтаксис

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;

Члены

PowerButtonPresent

Если этот элемент имеет значение TRUE, имеется системная кнопка питания.

SleepButtonPresent

Если этот элемент имеет значение TRUE, имеется кнопка спящего режима системы.

LidPresent

Если этот элемент имеет значение TRUE, имеется переключатель крышки.

SystemS1

Если этот член имеет значение TRUE, операционная система поддерживает спящий режим S1.

SystemS2

Если этот член имеет значение TRUE, операционная система поддерживает спящий режим S2.

SystemS3

Если этот член имеет значение TRUE, операционная система поддерживает спящий режим S3.

SystemS4

Если этот член имеет значение TRUE, операционная система поддерживает состояние спящего режима S4 (гибернацию).

SystemS5

Если этот элемент имеет значение TRUE, операционная система поддерживает состояние выключения питания S5 (мягкое выключение).

HiberFilePresent

Если этот член имеет значение TRUE, системный файл гибернации присутствует.

FullWake

Если этот элемент имеет значение TRUE, система поддерживает возможности пробуждения.

VideoDimPresent

Если этот элемент имеет значение TRUE, система поддерживает возможности затемнения видеотрансляций.

ApmPresent

Если этот элемент имеет значение TRUE, система поддерживает функции управления питанием APM BIOS.

UpsPresent

Если этот элемент имеет значение TRUE, имеется источник бесперебойного питания (ИП).

ThermalControl

Если этот элемент имеет значение TRUE, система поддерживает тепловые зоны.

ProcessorThrottle

Если этот элемент имеет значение TRUE, система поддерживает регулирование процессора.

ProcessorMinThrottle

Минимальный поддерживаемый уровень регулирования системного процессора, выраженный в процентах.

ProcessorThrottleScale

spare2[4]

ProcessorMaxThrottle

Максимальный поддерживаемый уровень регулирования системного процессора, выраженный в процентах.

FastSystemS4

Если этот член имеет значение TRUE, система поддерживает гибридное состояние спящего режима.

Hiberboot

WakeAlarmPresent

Если этот член имеет значение TRUE, платформа поддерживает устройства пробуждения ACPI. Дополнительные сведения об устройствах сигнализации пробуждения см. в разделе спецификации ACPI 9.18.

AoAc

Если этот элемент имеет значение TRUE, система поддерживает модель простоя S0 с низким энергопотреблением.

DiskSpinDown

Если этот элемент имеет значение TRUE, система поддерживает разрешение отключения питания для фиксированных дисковых устройств.

spare3[8]

Зарезервировано.

HiberFileType

AoAcConnectivitySupported

spare3[6]

Зарезервировано.

SystemBatteriesPresent

Если этот элемент имеет значение TRUE, в системе есть одна или несколько батарей.

BatteriesAreShortTerm

Если этот элемент имеет значение TRUE, системные батареи являются краткосрочными. Кратковременные батареи используются в источников бесперебойного питания (ИП).

BatteryScale[3]

Структура BATTERY_REPORTING_SCALE , содержащая сведения о том, как передаются метрики батареи системы.

AcOnLineWake

Наименьшее системное состояние спящего режима (Sx), которое создает событие пробуждения, когда система находится в режиме питания переменного тока. Этот элемент должен быть одним из значений типа перечисления SYSTEM_POWER_STATE.

SoftLidWake

Наименьшее системное состояние спящего режима (Sx), которое создает событие пробуждения с помощью переключателя крышки. Этот элемент должен быть одним из значений типа перечисления SYSTEM_POWER_STATE.

RtcWake

Самое низкое состояние спящего режима системы (Sx), поддерживаемое оборудованием, которое создает событие пробуждения через часы реального времени (RTC). Этот элемент должен быть одним из значений типа перечисления SYSTEM_POWER_STATE.

Чтобы вывести компьютер с помощью RTC, операционная система также должна поддерживать выход из спящего режима компьютера, когда RTC создает событие пробуждения. Таким образом, эффективное наименьшее состояние спящего режима, из которого событие пробуждения RTC может разбудить компьютер, — это самое низкое состояние спящего режима, поддерживаемое операционной системой, которое равно или превышает значение RtcWake. Чтобы определить состояния спящего режима, поддерживаемые операционной системой, проверка члены SystemS1, SystemS2, SystemS3 и SystemS4.

MinDeviceWakeState

Минимально допустимое состояние питания системы , поддерживающее события пробуждения. Этот элемент должен быть одним из значений типа перечисления SYSTEM_POWER_STATE. Обратите внимание, что это состояние может измениться при установке в системе разных драйверов устройств.

DefaultLowLatencyWake

Состояние питания системы по умолчанию, используемое, если приложение вызывает RequestWakeupLatency с LT_LOWEST_LATENCY. Этот элемент должен быть одним из значений типа перечисления SYSTEM_POWER_STATE.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Верхняя часть	winnt.h (включая Windows.h)

См. также раздел

CallNtPowerInformation

Состояния питания системы

Share via