Share via

PLATFORM_ACTIVITY_EVENT (Compact 2013)

  • Article

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.
  • 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

See Also

Reference

Power Management Enumerations