PCW_COUNTER_DESCRIPTOR结构 (wdm.h)

PCW_COUNTER_DESCRIPTOR 结构用于在计数器集注册期间提供有关计数器值的信息。 大多数开发人员不需要直接访问此结构,因为它由 CTRPP 工具生成的计数器集注册代码自动管理。

语法

typedef struct _PCW_COUNTER_DESCRIPTOR {
  USHORT Id;
  USHORT StructIndex;
  USHORT Offset;
  USHORT Size;
} PCW_COUNTER_DESCRIPTOR, *PPCW_COUNTER_DESCRIPTOR;

成员

Id

一个数值,该值指定此结构描述的计数器的 ID。 这应与提供程序计数器集清单中 计数器 元素的 id 字段中提供的值匹配。

StructIndex

一个数值,该值指定 PCW_DATA 结构的数组中的索引。 在对 PcwCreateInstancePcwAddInstance的后续调用中,PcwData[PcwCounterDescriptor->StructIndex] 描述的数据块将用作 ID 为 PcwCounterDescriptor->Id的计数器的数据源。

Offset

一个数值,该值指定相对于 StructIndex 字段指示的数据块的偏移量(以字节为单位)。 在对 PcwCreateInstancePcwAddInstance的后续调用中,地址 PcwData[PcwCounterDescriptor->StructIndex].Data + PcwCounterDescriptor->Offset 将用作 ID 为 PcwCounterDescriptor->Id的计数器值的开头。

Size

一个数值,该值指定 ID 为 PcwCounterDescriptor->Id的计数器的值的大小(以字节为单位)。 Size 字段应设置为 4(对于 UINT32 计数器值)或 8(对于 UINT64 计数器值)。

言论

大多数开发人员不需要直接使用此结构。 CTRPP 工具生成注册代码,以基于提供程序清单的内容初始化 PCW_COUNTER_DESCRIPTOR 结构。

计数器集注册期间提供了一组 PCW_COUNTER_DESCRIPTOR 结构(通过传递给 PcwRegisterPCW_REGISTRATION_INFORMATION 结构)。 记录数组中的信息,由 PcwCreateInstancePcwAddInstance 用来从 PCW_DATA 数组描述的数据块中提取计数器值。

要求

要求 价值
最低支持的客户端 在 Windows 7 及更高版本的 Windows 中可用。
标头 wdm.h (包括 Wdm.h、Ntddk.h)

另请参阅

_PCW_REGISTRATION_INFORMATION 结构

_PCW_DATA 结构

CTRPP

计数器复杂类型