Power Setting GUIDs

Power setting GUIDs identify power change events. This topic lists power setting GUIDs for notifications that are most useful to applications. An application should register for each power change event that might impact its behavior. Notification is sent each time a setting changes.

Power setting GUIDs are defined in WinNT.h.

GUID_ACDC_POWER_SOURCE

5D3E9A59-E9D5-4B00-A6BD-FF34FF516548

The system power source has changed. The Data member is a DWORD with values from the SYSTEM_POWER_CONDITION enumeration that indicates the current power source.

PoAc (0) - The computer is powered by an AC power source (or similar, such as a laptop powered by a 12V automotive adapter).

PoDc (1) - The computer is powered by an onboard battery power source.

PoHot (2) - The computer is powered by a short-term power source such as a UPS device.

GUID_BATTERY_PERCENTAGE_REMAINING

A7AD8041-B45A-4CAE-87A3-EECBB468A9E1

The remaining battery capacity has changed. The granularity varies from system to system but the finest granularity is 1 percent. The Data member is a DWORD that indicates the current battery capacity remaining as a percentage from 0 through 100.

GUID_CONSOLE_DISPLAY_STATE

6FE69556-704A-47A0-8F24-C28D936FDA47

The current monitor's display state has changed.

Windows 7, Windows Server 2008 R2, Windows Vista and Windows Server 2008: This notification is available starting with Windows 8 and Windows Server 2012.

The Data member is a DWORD with one of the following values.

0x0 - The display is off.

0x1 - The display is on.

0x2 - The display is dimmed.

GUID_GLOBAL_USER_PRESENCE

786E8A1D-B427-4344-9207-09E70BDCBEA9

The user status associated with any session has changed. This represents the combined status of user presence across all local and remote sessions on the system.

This notification is sent only services and other programs running in session 0. User-mode applications should register for GUID_SESSION_USER_PRESENCE instead.

Windows 7, Windows Server 2008 R2, Windows Vista and Windows Server 2008: This notification is available starting with Windows 8 and Windows Server 2012.

The Data member is a DWORD with one of the following values.

PowerUserPresent (0) - The user is present in any local or remote session on the system.

PowerUserInactive (2) - The user is not present in any local or remote session on the system.

GUID_IDLE_BACKGROUND_TASK

515C31D8-F734-163D-A0FD-11A08C91E8F1

The system is busy. This indicates that the system will not be moving into an idle state in the near future and that the current time is a good time for components to perform background or idle tasks that would otherwise prevent the computer from entering an idle state.

There is no notification when the system is able to move into an idle state. The idle background task notification does not indicate whether a user is present at the computer. The Data member has no information and can be ignored.

GUID_MONITOR_POWER_ON

02731015-4510-4526-99E6-E5A17EBD1AEA

The primary system monitor has been powered on or off. This notification is useful for components that actively render content to the display device, such as media visualization. These applications should register for this notification and stop rendering graphics content when the monitor is off to reduce system power consumption. The Data member is a DWORD that indicates the current monitor state.

0x0 - The monitor is off.

0x1 - The monitor is on.

Windows 8 and Windows Server 2012: New applications should use GUID_CONSOLE_DISPLAY_STATE instead of this notification.

GUID_POWER_SAVING_STATUS

E00958C0-C213-4ACE-AC77-FECCED2EEEA5

Battery saver has been turned off or on in response to changing power conditions. This notification is useful for components that participate in energy conservation. These applications should register for this notification and save power when battery saver is on.

The Data member is a DWORD that indicates battery saver state.

0x0 - Battery saver is off.

0x1 - Battery saver is on. Save energy where possible.

For general information about battery saver, see battery saver (in the hardware component guidelines).

GUID_POWERSCHEME_PERSONALITY

245d8541-3943-4422-b025-13A784F679B7

The active power scheme personality has changed. All power schemes map to one of these personalities. The Data member is a GUID that indicates the new active power scheme personality.

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

High Performance - The scheme is designed to deliver maximum performance at the expense of power consumption savings.

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

Power Saver - The scheme is designed to deliver maximum power consumption savings at the expense of system performance and responsiveness.

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

Automatic - The scheme is designed to automatically balance performance and power consumption savings.

GUID_SESSION_DISPLAY_STATUS

2B84C20E-AD23-4ddf-93DB-05FFBD7EFCA5

The display associated with the application's session has been powered on or off.

Windows 7, Windows Server 2008 R2, Windows Vista and Windows Server 2008: This notification is available starting with Windows 8 and Windows Server 2012.

This notification is sent only to user-mode applications. Services and other programs running in session 0 do not receive this notification. The Data member is a DWORD with one of the following values.

0x0 - The display is off.

0x1 - The display is on.

0x2 - The display is dimmed.

GUID_SESSION_USER_PRESENCE

3C0F4548-C03F-4c4d-B9F2-237EDE686376

The user status associated with the application's session has changed.

Windows 7, Windows Server 2008 R2, Windows Vista and Windows Server 2008: This notification is available starting with Windows 8 and Windows Server 2012.

This notification is sent only to user-mode applications running in an interactive session. Services and other programs running in session 0 should register for GUID_GLOBAL_USER_PRESENCE. The Data member is a DWORD with one of the following values.

PowerUserPresent (0) - The user is providing input to the session.

PowerUserInactive (2) - The user activity timeout has elapsed with no interaction from the user.

Note

All applications that run in an interactive user-mode session should use this setting. When kernel mode applications register for monitor status they should use GUID_CONSOLE_DISPLAY_STATUS instead.

**GUID\_LIDSWITCH\_STATE\_CHANGE**

BA3E0F4D-B817-4094-A2D1-D56379E6A0F3

The state of the lid has changed (open or closed). The callback won't be called until a lid device is found and its current state is known.

0x0 - The lid is closed.

0x1 - The lid is opened.

GUID_SYSTEM_AWAYMODE

98A7F580-01F7-48AA-9C0F-44352C29E5C0

The system is entering or exiting away mode. The Data member is a DWORD that indicates the current away mode state.

0x0 - The computer is exiting away mode.

0x1 - The computer is entering away mode.

Requirements

Requirement	Value
Header	WinNT.h