SYSTEM_POWER_LEVEL structure (winnt.h)

Contains information about system battery drain policy settings. This structure is part of the GLOBAL_USER_POWER_POLICY structure.

Syntax

typedef struct {
  BOOLEAN             Enable;
  BYTE                Spare[3];
  DWORD               BatteryLevel;
  POWER_ACTION_POLICY PowerPolicy;
  SYSTEM_POWER_STATE  MinSystemState;
} SYSTEM_POWER_LEVEL, *PSYSTEM_POWER_LEVEL;

Members

Enable

If this member is TRUE, the alarm should be activated when the battery discharges below the value set in BatteryLevel.

Spare[3]

Reserved.

BatteryLevel

The battery capacity for this battery discharge policy, expressed as a percentage.

PowerPolicy

A POWER_ACTION_POLICY structure that defines the action to take for this battery discharge policy.

MinSystemState

The minimum system sleep state to enter when the battery discharges below the value set in BatteryLevel. This member must be one of the SYSTEM_POWER_STATE enumeration type values.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Header winnt.h (include Windows.h)

See also

GLOBAL_USER_POWER_POLICY

POWER_ACTION_POLICY