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