PEP_QUERY_COMPONENT_PERF_STATES结构（pep_x.h）

项目
02/07/2025

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 通知而提供的数组。如果组件数组包含 N 个元素，则组件索引的范围从 0 到 N–1。

[in] Set

标识此 P 状态集的索引。如果 M 是此组件的 P 状态集数，则 P 状态集索引范围为 0 到 M-1。 PEP 之前指定了响应 PEP_DPM_QUERY_COMPONENT_PERF_CAPABILITIES 通知的 P 状态集数。

[in] States

指向输出缓冲区的指针。 PEP 将 PEP_PERF_STATE 结构的数组写入此缓冲区。每个数组元素描述由集成员指定的 P 状态集中的一个 P 状态。 Windows 电源管理框架（PoFx）分配了此缓冲区，该缓冲区保证足够大，以包含 PEP 之前写入 Discrete.CountPEP_QUERY_COMPONENT_PERF_SET 成员 PEP_DPM_QUERY_COMPONENT_PERF_SET 通知的长度数组。