PEP_QUERY_COMPONENT_PERF_STATES 結構 (pep_x.h)

發行項
02/27/2024

PEP_QUERY_COMPONENT_PERF_STATES 結構包含指定之 P 狀態集 (P 狀態) 值的離散效能狀態清單。

語法

typedef struct _PEP_QUERY_COMPONENT_PERF_STATES {
  [in] PEPHANDLE       DeviceHandle;
  [in] ULONG           Component;
  [in] ULONG           Set;
  [in] PPEP_PERF_STATE States;
} PEP_QUERY_COMPONENT_PERF_STATES, *PPEP_QUERY_COMPONENT_PERF_STATES;

成員

[in] DeviceHandle

識別裝置的 PEPHANDLE 值。 PEP 提供了此句柄，以回應先前的PEP_DPM_REGISTER_DEVICE 通知。

[in] Component

識別元件的索引。這個成員是PEP_DEVICE_REGISTER_V2結構中 Components 陣列的索引，PEP 先前為了回應此裝置的PEP_DPM_REGISTER_DEVICE通知而提供。如果 Components 陣列包含 N 個元素，元件索引的範圍從 0 到 N–1。

[in] Set

識別這個 P 狀態集的索引。如果 M 是此元件的 P 狀態集數目，P 狀態集索引的範圍從 0 到 M-1。 PEP 先前指定了 P 狀態集的數目，以回應 PEP_DPM_QUERY_COMPONENT_PERF_CAPABILITIES 通知。

[in] States

輸出緩衝區的指標。 PEP 會將 PEP_PERF_STATE 結構的數位寫入這個緩衝區。每個數位元素都會描述 Set 成員所指定的 P 狀態集合中的一個 P 狀態。 Windows 電源管理架構 (PoFx) 配置此緩衝區，保證夠大，足以包含 PEP 先前寫入至PEP_QUERY_COMPONENT_PERF_SET結構之 Discrete.Count 成員的長度陣列，以回應PEP_DPM_QUERY_COMPONENT_PERF_SET通知。