winnt.h) (SYSTEM_POWER_CAPABILITIES 结构

  • 项目

包含有关系统电源功能的信息。

语法

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，则 UPS) (不间断电源。

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，则系统电池是短期的。 短期电池用于不间断电源 (UPS) 。

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

如果应用程序使用 LT_LOWEST_LATENCY 调用 RequestWakeupLatency，则使用的默认系统电源状态。 此成员必须是 SYSTEM_POWER_STATE 枚举类型值之一。

要求

要求 值
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
标头 winnt.h (包括 Windows.h)

另请参阅

CallNtPowerInformation

系统电源状态