PERF_COUNTER_INFO 结构 (perflib.h)

定义提供程序使用的计数器的相关信息。 CTRPP 工具会根据指定的架构自动生成此结构。

语法

typedef struct _PERF_COUNTER_INFO {
  ULONG     CounterId;
  ULONG     Type;
  ULONGLONG Attrib;
  ULONG     Size;
  ULONG     DetailLevel;
  LONG      Scale;
  ULONG     Offset;
} PERF_COUNTER_INFO, *PPERF_COUNTER_INFO;

成员

CounterId

唯一标识计数器集中计数器的标识符。

Type

指定计数器的类型。 有关可能的计数器类型，请参阅 Windows 2003 部署指南中的 计数器类型 。

Attrib

指示如何显示此计数器的一个或多个属性。

可能的值包括：

值	含义
PERF_ATTRIB_BY_REFERENCE	通过引用而不是按值检索计数器的值。
PERF_ATTRIB_NO_DISPLAYABLE	不显示计数器值。
PERF_ATTRIB_NO_GROUP_SEPARATOR	显示计数器值时不要使用数字分隔符。
PERF_ATTRIB_DISPLAY_AS_REAL	将计数器值显示为实际值。
PERF_ATTRIB_DISPLAY_AS_HEX	将计数器值显示为十六进制数。

 

属性PERF_ATTRIB_NO_GROUP_SEPARATOR、PERF_ATTRIB_DISPLAY_AS_REAL和PERF_ATTRIB_DISPLAY_AS_HEX不是互斥的。 如果指定所有三个属性，则按给定的顺序为属性提供优先级。

Size

此结构的大小（以字节为单位）。

DetailLevel

指定计数器的目标受众。

可能的值为：

值	含义
PERF_DETAIL_NOVICE	可以将计数器显示给任何级别的用户。
PERF_DETAIL_ADVANCED	计数器很复杂，应仅向高级用户显示。

Scale

应用于计数器值的比例因子。 有效值范围为 –10 到 10。 如果未应用缩放，则为零。 如果此值为零，则刻度值为 1;如果此值为 1，则小数位数值为 10;如果此值为 –1，则缩放值为 .10;等等。

Offset

从 PERF_COUNTERSET_INSTANCE 块开头到计数器值的字节偏移量。

注解

此结构包含在 PERF_COUNTERSET_INFO 或 PERF_COUNTERSET_INSTANCE 块中。

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
标头	perflib.h

另请参阅

PERF_COUNTERSET_INFO

PERF_COUNTERSET_INSTANCE