Power Management Notification Interface (Compact 2013)

3/26/2014

Power Manager provides a set of functions that allows applications to receive notifications of power-related events. These functions are shown in the following table.

Notification Functions

Function

Description

RequestPowerNotifications

Requests that Power Manager send notifications of system power events.

StopPowerNotifications

Cancels a notification request made by RequestPowerNotifications.

Power Manager delivers notifications through message queues. To receive notifications, an application must create a message queue and pass the message queue handle to Power Manager by calling the RequestPowerNotifications function. Applications typically create a thread that waits for notifications from the message queue. Power Manager supports the notifications shown in the following table. An application developer can specify one or more of these notification flags to indicate which notifications his application is to receive.

Notification Types

Notification

Description

PBT_RESUME

Generates notifications when the system resumes from a suspended state.

PBT_POWERSTATUSCHANGE

Generates notifications when the system transitions to or from AC power.

PBT_TRANSITION

Generates notifications when Power Manager is performing a system power state change.

PBT_POWERINFOCHANGE

Generates notifications when battery information or AC line status changes.

PBT_SUSPENDKEYPRESSED

Generates notifications when the user has pressed the suspend key.

Applications can specify the bit mask POWER_NOTIFY_ALL to indicate that the application needs to receive every type of power notification.

See Also

Concepts

Power Manager Interfaces