Edit

PEP_PLATFORM_IDLE_STATE structure (pepfx.h)

  • Article

The PEP_PLATFORM_IDLE_STATE structure specifies the properties of a platform idle state.

Syntax

typedef struct _PEP_PLATFORM_IDLE_STATE {
  POHANDLE                      InitiatingProcessor;
  UCHAR                         InitiatingState;
  ULONG                         Latency;
  ULONG                         BreakEvenDuration;
  ULONG                         DependencyArrayUsed;
  ULONG                         DependencyArrayCount;
  PEP_PROCESSOR_IDLE_DEPENDENCY DependencyArray[ANYSIZE_ARRAY];
} PEP_PLATFORM_IDLE_STATE, *PPEP_PLATFORM_IDLE_STATE;

Members

InitiatingProcessor

A POHANDLE value that identifies the processor that initiates the transition to this platform idle state, or NULL if any processor can initiate the transition. If non-NULL, this handle represents the registration of the processor (as a device) with the Windows power management framework (PoFx).

InitiatingState

The index of the processor idle state that the processor enters to initiate the platform's entry to the specified platform idle state. If the IdleStates array in the PEP_PPM_QUERY_IDLE_STATES_V2 structure contains N elements, the idle states are numbered 0 to N-1 in the order in which they appear in the array.

Latency

The worst-case latency, in 100-nanosecond units, that the platform requires to wake from this idle state in response to a wake event.

BreakEvenDuration

The minimum amount of time, specified in 100-nanosecond units, that the platform must spend in this idle state to make a transition to this state worthwhile. PoFx uses this member value as a hint to avoid switching the platform to an idle state unless the platform is likely to remain in this state for at least the amount of time specified by BreakEvenDuration.

DependencyArrayUsed

The number of items in DependencyArray which were filled in by the PEP.

DependencyArrayCount

The number of elements in the DependencyArray array. The array contains one element for each processor in the hardware platform.

DependencyArray[ANYSIZE_ARRAY]

The first element in an array of PEP_PROCESSOR_IDLE_DEPENDENCY structures. This array specifies the set of dependencies that the platform idle state has on each processor. If the platform contains N processors, the array contains N elements, and processors are numbered 0 to N-1 in the order in which they are represented in the array.

Remarks

This structure is used in conjunction with the PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE notification. The State member of a PEP_PPM_QUERY_PLATFORM_STATE structure is a PEP_PLATFORM_IDLE_STATE structure.

Requirements

Requirement Value
Minimum supported client Supported starting with Windows 10.
Header pepfx.h (include Pep_x.h)

See also

PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE

PEP_PPM_QUERY_IDLE_STATES_V2

PEP_PPM_QUERY_PLATFORM_STATE

PEP_PROCESSOR_IDLE_DEPENDENCY