Edit

Share via

PEP_PPM_QUERY_IDLE_STATES structure (pep_x.h)

  • Article

The PEP_PPM_QUERY_IDLE_STATES structure describes the idle states of a particular processor.

Syntax

typedef struct _PEP_PPM_QUERY_IDLE_STATES {
  [in]  ULONG                    Count;
  [out] ULONG                    MaximumCoordinatedProcessors;
        PEP_PROCESSOR_IDLE_STATE IdleStates[ANYSIZE_ARRAY];
} PEP_PPM_QUERY_IDLE_STATES, *PPEP_PPM_QUERY_IDLE_STATES;

Members

[in] Count

The number of elements in the IdleStates array. This member is set to the IdleStateCount value that the PEP previously supplied for this processor in response to the PEP_NOTIFY_PPM_QUERY_CAPABILITIES notification.

[out] MaximumCoordinatedProcessors

The maximum number of secondary processors that are subordinate to this processor for any transitions to idle states. A primary processor can enter the selected idle state only after the secondary processors have entered their corresponding idle states. The PEP must set the MaximumCoordinatedProcessors member to a number that is less than the total number of processors in the hardware platform.

[in] IdleStates[ANYSIZE_ARRAY]

The first element in an array of PEP_PROCESSOR_IDLE_STATE structures. Each array element describes one of the idle states of this processor. If the array contains more than one element, the additional elements immediately follow the end of the PEP_PPM_QUERY_IDLE_STATES structure. The number of array elements is specified by the Count member. The buffer that PoFx allocates to hold this structure is guaranteed to be large enough to contain the PEP_PPM_QUERY_IDLE_STATES structure plus any array elements that follow this structure. Each idle state is identified by its array index. If the array contains N elements, idle state indexes range from 0 to N–1.

Remarks

This structure is used by the PEP_NOTIFY_PPM_QUERY_IDLE_STATES notification. The Count member of the structure contains an input value that PoFx supplies when this notification is sent. The other two members contain output values that the PEP writes to the structure in response to the notification.

Requirements

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

See also

PEP_NOTIFY_PPM_QUERY_CAPABILITIES

PEP_NOTIFY_PPM_QUERY_IDLE_STATES

PEP_PROCESSOR_IDLE_STATE