PERF_COUNTER_IDENTIFIER 结构 (perflib.h)
包含有关 包含 结构的 PERF_COUNTER_IDENTIFIER 块的信息。 PERF_COUNTER_IDENTIFIER块提供有关性能计数器规范的信息,并按顺序包含以下项:
- PERF_COUNTER_IDENTIFIER结构
- 一个可选的以 null 结尾的 UTF-16LE 字符串,用于指定实例名称
- 根据需要进行填充,使块的大小为 8 个字节的倍数。
语法
typedef struct _PERF_COUNTER_IDENTIFIER {
GUID CounterSetGuid;
ULONG Status;
ULONG Size;
ULONG CounterId;
ULONG InstanceId;
ULONG Index;
ULONG Reserved;
} PERF_COUNTER_IDENTIFIER, *PPERF_COUNTER_IDENTIFIER;
成员
CounterSetGuid
性能计数器集的 GUID 。
Status
指示添加或删除性能计数器的操作是成功还是失败的错误代码。
Size
PERF_COUNTER_IDENTIFIER块的总大小(以字节为单位)。 块的总大小是 PERF_COUNTER_IDENTIFIER 结构、指定实例名称和填充的字符串的大小之和。
CounterId
性能计数器的标识符。 PERF_WILDCARD_COUNTER 指定所有计数器。
InstanceId
实例标识符。 如果不想根据实例标识符筛选结果,请指定0xFFFFFFFF。
Index
PERF_COUNTER_IDENTIFIER块序列中返回与此PERF_COUNTER_IDENTIFIER块对应的计数器数据的位置。 由 PerfQueryCounterInfo 设置。
Reserved
保留。
注解
为单实例计数器集指定计数器集标识符时,不得在 PERF_COUNTER_IDENTIFIER 块的其他数据中指定实例名称。 PERF_COUNTER_IDENTIFIER块的大小必须是PERF_COUNTER_IDENTIFIER结构的大小。
另一方面,为多实例计数器集指定计数器集标识符时,必须在 PERF_COUNTER_IDENTIFIER 块的其他数据中指定实例名称。 除非PERF_COUNTER_IDENTIFIER块的大小大于PERF_COUNTER_IDENTIFIER结构的大小,否则标识符无效。 如果不想基于实例名称筛选计数器集,请使用 PERF_WILDCARD_INSTANCE 作为实例名称。
PerfAddCounters 和 PerfDeleteCounters 函数接受一系列PERF_COUNTER_IDENTIFIER块来定义要从查询中添加或删除的计数器规范。
PerfQueryCounterInfo 函数获取一系列PERF_COUNTER_IDENTIFIER块,以指示查询中的计数器规范,并在 Index 成员中指示查询获取结果的顺序。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 10版本 1607 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2016 [仅限桌面应用] |
标头 | perflib.h |