通过

电源设置 GUID

  • 项目

电源设置 GUID 标识电源更改事件。 本主题列出了对应用程序最有用的通知的电源设置 GUID。 应用程序应注册可能影响其行为的每个电源更改事件。 每次设置更改时都会发送通知。

电源设置 GUID 是在 WinNT.h 中定义的。

GUID_ACDC_POWER_SOURCE (5D3E9A59-E9D5-4B00-A6BD-FF34FF516548)

系统电源已更改。

Data 成员是一个 DWORD，其中包含指示当前电源的 SYSTEM_POWER_CONDITION 枚举中的值：

PoAc (0) - 计算机由 AC 电源供电（或类似电源，如由 12V 汽车适配器供电的笔记本电脑）。

PoDc (1) - 计算机由板载电池电源供电。

PoHot (2) - 计算机由短期电源（如 UPS 设备）供电。

GUID_BATTERY_PERCENTAGE_REMAINING (A7AD8041-B45A-4CAE-87A3-EECBB468A9E1)

剩余电池容量已更改。 粒度因系统而异，但最佳粒度为 1%。

Data 成员是一个 DWORD，用于指示当前电池剩余电量，以 0 到 100 的百分比表示。

GUID_CONSOLE_DISPLAY_STATE (6FE69556-704A-47A0-8F24-C28D936FDA47)

当前监视器的显示状态已更改。

Windows 7、Windows Server 2008 R2、Windows Vista 和 Windows Server 2008：此通知从 Windows 8 和 Windows Server 2012 开始提供。

Data 成员是包含 MONITOR_DISPLAY_STATE 枚举值的 DWORD：

PowerMonitorOff (0) - 显示器已关闭。

PowerMonitorOn (1) - 显示器已打开。

PowerMonitorDim (2) - 显示器处于灰显状态。

GUID_GLOBAL_USER_PRESENCE (786E8A1D-B427-4344-9207-09E70BDCBEA9)

与任何会话关联的用户状态已更改。 这表示系统上所有本地和远程会话的用户状态的组合状态。

此通知仅发送给在会话 0 中运行的服务和其他程序。 用户模式应用程序应改为注册 GUID_SESSION_USER_PRESENCE。

Windows 7、Windows Server 2008 R2、Windows Vista 和 Windows Server 2008：此通知从 Windows 8 和 Windows Server 2012 开始提供。

Data 成员是一个 DWORD，其中包含 USER_ACTIVITY_PRESENCE 枚举中的以下值之一：

PowerUserPresent (0) - 用户存在于系统上的任何本地或远程会话中。

PowerUserInactive (2) - 用户不在系统上的任何本地或远程会话中。

GUID_IDLE_BACKGROUND_TASK (515C31D8-F734-163D-A0FD-11A08C91E8F1)

系统正忙。 这表示系统近期不会进入空闲状态，而当前时间是组件执行后台或空闲任务的好时机，否则将阻止计算机进入空闲状态。

当系统能够进入空闲状态时，不会提供通知。 空闲后台任务通知不会指示用户是否在计算机中存在。

Data 成员不提供任何信息，可以忽略。

GUID_LIDSWITCH_STATE_CHANGE (BA3E0F4D-B817-4094-A2D1-D56379E6A0F3)

盖子的状态已更改（打开与关闭）。 找到盖子设备并且其当前状态已知后，才会调用回调。

0x0 - 盖子已关闭。

0x1 - 盖子已打开。

GUID_MONITOR_POWER_ON (02731015-4510-4526-99E6-E5A17EBD1AEA)

主系统监视器已打开或关闭。 此通知对于主动将内容呈现到显示设备的组件（如媒体可视化）非常有用。 当监视器关闭以减少系统能耗时，应用程序应注册此通知并停止呈现图形内容。

Data 成员是指示当前监视器状态的 DWORD：

0x0 - 监视器已关闭。

0x1 - 监视器已打开。

Windows 8 和 Windows Server 2012：新应用程序应使用 GUID_CONSOLE_DISPLAY_STATE 而不是此通知。

GUID_POWER_SAVING_STATUS (E00958C0-C213-4ACE-AC77-FECCED2EEEA5)

为了响应电源条件的变化，已关闭或打开节电模式。 此通知对于参与节能的组件非常有用。 应用程序应注册此通知，并在节电模式打开时节省电能。

Data 成员是指示节点模式状态的 DWORD：

0x0 - 节电模式已关闭。

0x1 - 节电模式已打开。 请尽可能节省能源。

有关节电模式的常规信息，请参阅节电模式（在硬件组件指南中）。

GUID_ENERGY_SAVER_STATUS (550E8400-E29B-41D4-A716-446655440000)

重要

这些信息与预发布产品相关，在商业发行之前可能会发生实质性修改。 Microsoft 对此处提供的信息不提供任何明示或暗示的保证。

节能模式状态已更改。 此通知对于参与节能的组件非常有用。 注册此通知的应用程序可以在不同程度上节省电源，具体取决于节能模式是否有效。

Data 成员是一个 DWORD，其中的值来自于指示当前节能模式状态的 ENERGY_SAVER_STATUS 枚举。

ENERGY_SAVER_OFF - 节能模式已关闭。

ENERGY_SAVER_STANDARD - 节能模式采用标准模式。 如果用户体验影响极小，则节省能源。

ENERGY_SAVER_HIGH_SAVINGS - 节能模式采用高节能模式。 请尽可能节省能源。

GUID_POWERSCHEME_PERSONALITY (245D8541-3943-4422-B025-13A784F679B7)

主动电源方案个性已更改。 所有电源方案映射到这些个性其中之一。

Data 成员是一个 GUID，用于指示新的主动电源方案个性：

GUID_MIN_POWER_SAVINGS (8C5E7FDA-E8BF-4A96-9A85-A6E23A8C635C)

高性能 - 此方案旨在以牺牲能耗节省为代价提供最高性能。

GUID_MAX_POWER_SAVINGS (A1841308-3541-4FAB-BC81-F71556F20B4A)

节电模式 - 此方案旨在以牺牲系统性能和响应能力为代价提供最大能耗节省。

GUID_TYPICAL_POWER_SAVINGS (381B4222-F694-41F0-9685-FF5BB260DF2E)

自动 - 此方案旨在自动平衡性能和能耗节省。

GUID_SESSION_DISPLAY_STATUS (2B84C20E-AD23-4DDF-93DB-05FFBD7EFCA5)

与应用程序会话关联的显示器已打开或关闭。

Windows 7、Windows Server 2008 R2、Windows Vista 和 Windows Server 2008：此通知从 Windows 8 和 Windows Server 2012 开始提供。

此通知仅发送到用户模式应用程序。 会话 0 中运行的服务和其他程序不会收到此通知。

Data 成员是包含 MONITOR_DISPLAY_STATE 枚举值的 DWORD：

PowerMonitorOff (0) - 显示器已关闭。

PowerMonitorOn (1) - 显示器已打开。

PowerMonitorDim (2) - 显示器处于灰显状态。

注意

在交互式用户模式会话中运行的所有应用程序应使用此设置。 当内核模式应用程序注册以监视状态时，它们应改用 GUID_CONSOLE_DISPLAY_STATUS。

GUID_SESSION_USER_PRESENCE (3C0F4548-C03F-4C4D-B9F2-237EDE686376)

与应用程序会话关联的用户状态已更改。

Windows 7、Windows Server 2008 R2、Windows Vista 和 Windows Server 2008：此通知从 Windows 8 和 Windows Server 2012 开始提供。

此通知仅发送到在交互式会话中运行的用户模式应用程序。 会话 0 中运行的服务和其他程序应注册 GUID_GLOBAL_USER_PRESENCE。

Data 成员是一个 DWORD，其中包含 USER_ACTIVITY_PRESENCE 枚举中的以下值之一：

PowerUserPresent (0) - 用户正在向会话提供输入。

PowerUserInactive (2) - 用户活动超时已过，并且没有来自用户的交互。

GUID_SYSTEM_AWAYMODE (98A7F580-01F7-48AA-9C0F-44352C29E5C0)

系统正在进入或退出离开模式。

Data 成员是指示当前离开模式状态的 DWORD：

0x0 - 计算机正在退出离开模式。

0x1 - 计算机正在进入离开模式。

要求

要求 值
标头
Winnt.h