PLATFORM_ACTIVITY_EVENT (Compact 2013)
3/26/2014
PLATFORM_ACTIVITY_EVENT defines the device activity states that can be sent by Power Manager to custom Power Management Extensions (PMEs).
Syntax
typedef enum {
NoActivity=0,
UserActivity,
UserInactivity,
SystemActivity,
SystemInactivity,
EnterUnattendedModeRequest,
LeaveUnattendedModeRequest,
Timeout,
RestartTimeouts,
PowerSourceChange,
Resume,
SystemPowerStateChange,
SystemPowerStateAPI,
PmShutDown,
PmReloadActivityTimeouts,
PowerButtonPressed,
AppButtonPressed,
BootPhaseChanged,
PowerManagerExt = 0x800,
ExternedEvent = 0x1000
} PLATFORM_ACTIVITY_EVENT, *PPLATFORM_ACTIVITY_EVENT;
Elements
- NoActivity
No activity. This event is ignored.
- UserActivity
An input mechanism has received input from a user.
- UserInactivity
The user inactivity time limit has been reached without any input mechanism receiving user input.
- SystemActivity
The system has executed I/O, or at least one non-blocked thread has executed to the completion of its quantum. This event can be sent many times if an application is keeping the system in an activate state so that it does not automatically suspend. For example, a media player that is currently playing may do this.
- SystemInactivity
The system inactivity time limit has been reached without any operation taking place.
- EnterUnattendedModeRequest
An application or system component has requested to enter unattended mode. This keeps the system active but appears dominant to a user, so that background processing can be done.
- LeaveUnattendedModeRequest
An application that requested to enter unattended mode has finished its background processing and no longer needs the system to be in unattended mode.
- Timeout
An activity timeout has expired, such as for user, system, OEM, or other activity.
- RestartTimeouts
The timeout periods have been restarted for user, system, OEM, and any other activity.
- PowerSourceChange
The power source changed from AC to battery, or from battery to AC.
- Resume
The system has resumed from a suspended state.
- SystemPowerStateChange
A change in system power state has occurred.
- SystemPowerStateAPI
SetSystemPowerState was called.
- PmShutDown
Indicates to the PMEs that the Power Manager has been instructed to exit.
- PmReloadActivityTimeouts
Timeout values have been reloaded from the system registry.
- PowerButtonPressed
The power button for the device was pressed.
- AppButtonPressed
A device application button was pressed.
- BootPhaseChanged
The system has entered a new boot phase.
- PowerManagerExt
An event from inside the Power Manager will have an enumeration value less than this value.
- ExternedEvent
An event from outside the Power Manager will have an enumeration value greater than or equal to this value.
Remarks
These events are sent to the PMEs when they have occurred. They are not necessarily sent synchronously with the event taking place. An OEM may choose not to implement some or all of these events.
Requirements
Header |
Pmext.h |