PEP_QUERY_COMPONENT_PERF_SET_NAME 结构 (pep_x.h)

项目
02/29/2024

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 先前为响应此设备的PEP_DPM_REGISTER_DEVICE通知而提供的PEP_DEVICE_REGISTER_V2结构中 Components 数组的索引。如果 Components 数组包含 N 个元素，则组件索引的范围为 0 到 N–1。

[in] Set

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

[in, NameSize

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

[in] Name

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

注解

此结构由 PEP_DPM_QUERY_COMPONENT_PERF_SET_NAME 通知使用。结构的 DeviceHandle、 Component 和 Set 成员包含发送此通知时 PoFx 提供的输入值。如果 Name 成员为非 NULL，则 PEP 会将一个字符串写入 Name 指向的缓冲区。如果 Name 为 NULL，PEP 会将所需的缓冲区大小写入 NameSize 成员。

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