PEP_QUERY_COMPONENT_PERF_SET_NAME结构（pep_x.h）

项目
02/07/2025

PEP_QUERY_COMPONENT_PERF_SET_NAME 结构包含有关组件一组性能状态值（P 状态集）的查询信息。

语法

typedef struct _PEP_QUERY_COMPONENT_PERF_SET_NAME {
  [in]      PEPHANDLE DeviceHandle;
  [in]      ULONG     Component;
  [in]      ULONG     Set;
  [in, out] USHORT    NameSize;
  [in]      PWCHAR    Name;
} PEP_QUERY_COMPONENT_PERF_SET_NAME, *PPEP_QUERY_COMPONENT_PERF_SET_NAME;

成员

[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, NameSize

在输入时，Name 成员指向的缓冲区的大小（以字节为单位）。如果名称为 NULL，PEP 将使用名称字符串所需的缓冲区大小覆盖 NameSize 的输入值。

[in] Name

指向输出缓冲区的指针。 PEP 将 P 状态的名称写入此缓冲区。该名称存储为宽字符、以 null 结尾的字符串。如果 Windows 电源管理框架（PoFx）需要确定为名称字符串分配的缓冲区的大小，则名称成员为 NULL。如果名称为非 NULL，则缓冲区必须足够大，才能包含整个字符串，包括终止 null 字符。

言论

PEP_DPM_QUERY_COMPONENT_PERF_SET_NAME 通知使用此结构。 DeviceHandle、组件，以及设置结构的成员包含发送此通知时 PoFx 提供的输入值。如果名称成员为非 NULL，PEP 会将字符串写入 Name指向的缓冲区。如果名称为 NULL，PEP 会将所需的缓冲区大小写入 NameSize 成员。

PEP 写入输出缓冲区的字符串应包含 P 状态集的描述性名称。此名称旨在使日志条目和诊断消息更易于理解。