PEP_PPM_IDLE_SELECT 結構 (pep_x.h)

發行項
02/29/2024

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 成員值等於先前提供給 PEP 以回應PEP_NOTIFY_PPM_QUERY_IDLE_STATES通知的 MaximumCoordinatedProcessors 值。

[in] DependencyArray

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

[out] PlatformIdleStateIndex

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