system-power-information-str.md

description	ms.assetid	title	ms.topic	ms.date	topic_type	api_name	api_type	api_location
Contains information about the idleness of the system.	f6349b7c-1835-4492-95e3-9ce142628804	SYSTEM_POWER_INFORMATION structure	reference	05/31/2018	APIRef kbSyntax	SYSTEM_POWER_INFORMATION	NA

SYSTEM_POWER_INFORMATION structure

Contains information about the idleness of the system.

Syntax

typedef struct _SYSTEM_POWER_INFORMATION {
  ULONG MaxIdlenessAllowed;
  ULONG Idleness;
  ULONG TimeRemaining;
  UCHAR CoolingMode;
} SYSTEM_POWER_INFORMATION, *PSYSTEM_POWER_INFORMATION;

Members

MaxIdlenessAllowed

The idleness at which the system is considered idle and the idle time-out begins counting, expressed as a percentage. Dropping below this number causes the timer to be canceled.

Idleness

The current idle level, expressed as a percentage.

TimeRemaining

The time remaining in the idle timer, in seconds.

CoolingMode

The current system cooling mode. This member must one of the following values.

Value	Meaning
PO_TZ_ACTIVE 0	The system is currently in Active cooling mode.
PO_TZ_INVALID_MODE 2	The system does not support CPU throttling, or there is no thermal zone defined in the system.
PO_TZ_PASSIVE 1	The system is currently in Passive cooling mode.

Remarks

Note that this structure definition was accidentally omitted from WinNT.h. This error will be corrected in the future. In the meantime, to compile your application, include the structure definition contained in this topic in your source code.

Requirements

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]

See also

CallNtPowerInformation