Edit

PEP_PPM_IDLE_EXECUTE structure (pepfx.h)

  • Article

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

Syntax

typedef struct _PEP_PPM_IDLE_EXECUTE {
  [out] NTSTATUS Status;
  [in]  ULONG    ProcessorState;
  [in]  ULONG    PlatformState;
} PEP_PPM_IDLE_EXECUTE, *PPEP_PPM_IDLE_EXECUTE;

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 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).

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

PEP_NOTIFY_PPM_QUERY_PLATFORM_STATES