Edit

PEP_PPM_IDLE_EXECUTE_V2 structure (pepfx.h)

  • Article

The PEP_PPM_IDLE_EXECUTE_V2 structure specifies the idle state that the processor is to enter.

Syntax

typedef struct _PEP_PPM_IDLE_EXECUTE_V2 {
  [out] NTSTATUS Status;
  [in]  ULONG    ProcessorState;
  [in]  ULONG    PlatformState;
        ULONG    CoordinatedStateCount;
        PULONG   CoordinatedStates;
} PEP_PPM_IDLE_EXECUTE_V2, *PPEP_PPM_IDLE_EXECUTE_V2;

Members

[out] Status

An NTSTATUS value that indicates whether the processor idle state transition was successful. The platform extension plug-in (PEP) sets this member to STATUS_SUCCESSFUL if the transition succeeded. Otherwise, this member is set to an appropriate error status code.

[in] ProcessorState

The index of the processor idle state that the processor is to enter. The PEP previously specified the supported processor idle states in response to a PEP_NOTIFY_PPM_QUERY_IDLE_STATES_V2 notification. If the PEP specified N processor idle states, valid processor-idle-state indexes range from 0 to N-1.

[in] PlatformState

The index of the platform idle state that the hardware platform will enter when the processor enters the processor idle state specified by ProcessorState. The PEP previously specified the supported platform idle states in response to a PEP_NOTIFY_PPM_QUERY_PLATFORM_STATES notification. If the PEP specified M platform idle states, valid platform-idle-state indexes range from 0 to M-1. If no change in platform idle state will occur, this member will contain the value PEP_PLATFORM_IDLE_STATE_NONE (0xffffffff).

CoordinatedStateCount

Supplies the number of coordinated idle states being entered by this transition.

CoordinatedStates

Supplies a pointer to an array of coordinated idle states that are being entered by this transition.

Remarks

This structure is used by the PEP_NOTIFY_PPM_IDLE_EXECUTE notification. The ProcessorState and PlatformState members contain input values that are supplied by the Windows power management framework (PoFx). The Status member contains an output value that the PEP writes to this member.

Requirements

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

See also

PEP_NOTIFY_PPM_IDLE_EXECUTE

PEP_NOTIFY_PPM_QUERY_IDLE_STATES_V2

PEP_NOTIFY_PPM_QUERY_PLATFORM_STATES