PEP_PPM_FEEDBACK_READ 结构 (pepfx.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 开始支持。
标头 pepfx.h (包括 Pep_x.h)

另请参阅