PEP_PPM_IDLE_SELECT結構（pep_x.h）

發行項
02/07/2025

PEP_PPM_IDLE_SELECT 結構描述處理器可以進入且仍然滿足作系統所指定之條件約束的最節能閑置狀態。

語法

typedef struct _PEP_PPM_IDLE_SELECT {
  [in]  PPEP_PROCESSOR_IDLE_CONSTRAINTS Constraints;
  [out] BOOLEAN                         AbortTransition;
  [out] ULONG                           IdleStateIndex;
  [out] ULONG                           DependencyArrayUsed;
  [in]  ULONG                           DependencyArrayCount;
  [in]  PPEP_PROCESSOR_IDLE_DEPENDENCY  DependencyArray;
  [out] ULONG                           PlatformIdleStateIndex;
} PEP_PPM_IDLE_SELECT, *PPEP_PPM_IDLE_SELECT;

成員

[in] Constraints

PEP_PROCESSOR_IDLE_CONSTRAINTS 結構的指標，指定所選處理器閑置狀態必須滿足的條件約束。作系統會設定這個結構中的值。平臺延伸模組外掛程式（PEP）必須選取滿足這些條件約束的處理器閑置狀態。

[out] AbortTransition

是否取消暫止轉換至處理器閑置狀態。如果 PEP 需要作系統取消暫止的轉換，並將這個成員設定為 TRUE，否則設定為 FALSE。如果 PEP 想要將工作排入佇列，並在處理器進入閑置之前讓 Windows 核心處理此工作，則 PEP 會選取此選項。

[out] IdleStateIndex

識別處理器要輸入之閑置狀態的索引。如果 AbortTransition = TRUE，則會忽略此成員。如果處理器支援 N 個閒置狀態，閑置狀態索引的範圍從 0 到 N–1。 PEP 提供此處理器支援的閑置狀態數目，以回應先前的 PEP_NOTIFY_PPM_QUERY_IDLE_STATES 通知。

[out] DependencyArrayUsed

PEP 實際寫入輸出緩衝區的陣列元素數目，指向 DependencyArray 成員。

[in] DependencyArrayCount

DependencyArray 成員所指向的陣列中元素數目上限。 DependencyArrayCount 成員值等於 MaximumCoordinatedProcessors PEP 先前提供的回應 PEP_NOTIFY_PPM_QUERY_IDLE_STATES 通知的值。

[in] DependencyArray

PEP 寫入 PEP_PROCESSOR_IDLE_DEPENDENCY 結構數位之輸出緩衝區的指標。此陣列的元素會指定處理器閒置相依性或必須符合的喚醒相依性，此閒置轉換才能成功。 PEP 會將 DependencyArrayUsed 成員設定為 PEP 寫入緩衝區的實際數位元素數目。輸出緩衝區是由 Windows 電源管理架構（PoFx）所配置，而且保證足以包含 DependencyArrayCount 成員所指定的數位元素數目。

[out] PlatformIdleStateIndex

當處理器進入選取的處理器閑置狀態時，平臺要輸入的平臺閑置狀態索引。只有在平臺與處理器同時進入閑置狀態時，PEP 才應設定此成員。如果abortTransition 為TRUE，則會忽略此成員。