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 成员;如果计数器生成相对值,则写入 NominalCount,ActualCount 成员。
首次打开电源时,即时计数器和相对计数器将重置为零,但读取相对计数器会导致计数重置为零,而读取即时计数器不会重置计数。 PEP 之前指示计数器是即时的还是相对的,以响应 PEP_NOTIFY_PPM_QUERY_FEEDBACK_COUNTERS 通知。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | 从 Windows 10 开始支持。 |
标头 | pep_x.h (包括 Pep_x.h) |