PEP_PPM_FEEDBACK_READ 结构 (pep_x.h)

  • 项目

PEP_PPM_FEEDBACK_READ 结构包含从处理器性能反馈计数器读取的值。

语法

typedef struct _PEP_PPM_FEEDBACK_READ {
  ULONG CounterIndex;
  union {
    ULONG64 InstantaneousValue;
    struct {
      ULONG64 NominalCount;
      ULONG64 ActualCount;
    };
  };
} PEP_PPM_FEEDBACK_READ, *PPEP_PPM_FEEDBACK_READ;

成员

CounterIndex

标识要读取的处理器性能反馈计数器的索引。 如果平台扩展插件 (PEP) 支持此处理器的 N 个计数器，则计数器索引范围为 0 到 N-1。 PEP 以前提供了支持的计数器数，以响应 PEP_NOTIFY_PPM_QUERY_CAPABILITIES 通知。

InstantaneousValue

如果计数器生成即时值，则为从计数器读取的当前瞬时值。

NominalCount

计数器的名义累计值。 累计值是到目前为止已从计数器硬件读取的所有实际值的总和。

ActualCount

从计数器读取的实际值。

注解

如果计数器生成即时值，则未命名联合包含即时计数器值;如果计数器硬件生成相对值，则包含相对计数器值和累积计数器值。

此结构由 PEP_NOTIFY_PPM_FEEDBACK_READ 通知使用。 结构的 CounterIndex 成员包含 Windows 电源管理框架 (PoFx) 设置此通知时提供的输入值。 其他成员包含 PEP 写入结构以响应通知的输出值。 如果计数器生成即时值，则 PEP 写入 InstantaneousValue 成员;如果计数器生成相对值，则 PEP 将写入 NominalCount 和 ActualCount 成员。

当首次打开电源时，即时计数器和相对计数器都重置为零，但读取相对计数器会导致计数重置为零，而读取瞬时计数器不会重置计数。 PEP 之前指示计数器是即时的还是相对的，以响应 PEP_NOTIFY_PPM_QUERY_FEEDBACK_COUNTERS 通知。

要求

要求 值
最低受支持的客户端 从 Windows 10 开始支持。
标头 pep_x.h (包括 Pep_x.h)

另请参阅