PROCESSOR_POWER_POLICY structure (winnt.h)

Contains information about processor performance control and C-states.

Syntax

typedef struct _PROCESSOR_POWER_POLICY {
  DWORD                       Revision;
  BYTE                        DynamicThrottle;
  BYTE                        Spare[3];
  DWORD                       DisableCStates : 1;
  DWORD                       Reserved : 31;
  DWORD                       PolicyCount;
  PROCESSOR_POWER_POLICY_INFO Policy[3];
} PROCESSOR_POWER_POLICY, *PPROCESSOR_POWER_POLICY;

Members

Revision

The current structure revision level. Set this value by calling ReadProcessorPwrScheme before using a PROCESSOR_POWER_POLICY structure to set power policy.

DynamicThrottle

The current processor performance state policy. This member must be one of the values described in Processor Performance Control Policy Constants.

Spare[3]

Reserved; set to zero.

DisableCStates

Reserved; set to zero.

Reserved

Reserved; set to zero.

PolicyCount

The number of elements in the Policy array.

Policy[3]

An array of PROCESSOR_POWER_POLICY_INFO structures that defines values used to apply processor C-state policy settings. Policy[0] corresponds to ACPI C-state C1, Policy[1] corresponds to C2, and Policy[2] corresponds to C3. The AllowPromotion member determines whether the processor can be promoted to the state. For example, if Policy[0].AllowPromotion is 0, the computer cannot transition from C0 to C1.

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

CallNtPowerInformation

PROCESSOR_POWER_POLICY_INFO