电源设置 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