PERF_COUNTER_IDENTIFIER 结构 (perflib.h)

  • 项目

包含有关 包含 结构的 PERF_COUNTER_IDENTIFIER 块的信息。 PERF_COUNTER_IDENTIFIER块提供有关性能计数器规范的信息，并按顺序包含以下项：

  1. PERF_COUNTER_IDENTIFIER结构
  2. 一个可选的以 null 结尾的 UTF-16LE 字符串，用于指定实例名称
  3. 根据需要进行填充，使块的大小为 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

另请参阅

PerfAddCounters

PerfDeleteCounters

PerfQueryCounterInfo