PO_SPR_ACTIVE_SESSION_DATA structure (ntpoapi.h)

Stores information that indicates whether a System Power Report's Active Session is starting or ending.

Syntax

typedef struct _PO_SPR_ACTIVE_SESSION_DATA {
  BOOLEAN Start;
  GUID    ActiveSessionGuid;
} PO_SPR_ACTIVE_SESSION_DATA, *PPO_SPR_ACTIVE_SESSION_DATA;

Members

Start

A boolean value that indicates whether the session is starting or ending.

ActiveSessionGuid

The Active session GUID for the session.

Remarks

To register for System Power Report's Active Session notifications, you must call PowerSettingRegisterNotification function with these values:

• SettingGuid: Pass GUID_SPR_ACTIVE_SESSION_CHANGE.
• Flags: Set to DEVICE_NOTIFY_CALLBACK.
• Recipient: A DEVICE_NOTIFY_SUBSCRIBE_PARAMETERS structure, in which the Callback member is set to your implementation of the DEVICE_NOTIFY_CALLBACK_ROUTINE callback routine that gets called when the session starts or ends.

If the registration is successful, the DEVICE_NOTIFY_CALLBACK_ROUTINE callback is invoked with these value:

• Type: PBT_POWERSETTINGCHANGE to indicate a power setting change.
• UpdateSetting: Is a POWERBROADCAST_SETTING structure; the PowerSetting member is set to GUID_SPR_ACTIVE_SESSION_CHANGE, the DataLength member is a _PO_SPR_ACTIVE_SESSION_DATA structure.

Requirements

Requirement	Value
Header	ntpoapi.h

See also

PowerSettingRegisterNotification

POWERBROADCAST_SETTING

DEVICE_NOTIFY_CALLBACK_ROUTINE