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) |