PCW_COUNTER_DESCRIPTOR结构（wdm.h）

2025-02-07

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 结构的数组中的索引。在对 PcwCreateInstance 或 PcwAddInstance的后续调用中，PcwData[PcwCounterDescriptor->StructIndex] 描述的数据块将用作 ID 为 PcwCounterDescriptor->Id的计数器的数据源。

Offset

一个数值，该值指定相对于 StructIndex 字段指示的数据块的偏移量（以字节为单位）。在对 PcwCreateInstance 或 PcwAddInstance的后续调用中，地址 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 结构（通过传递给 PcwRegister的 PCW_REGISTRATION_INFORMATION 结构）。记录数组中的信息，由 PcwCreateInstance 或 PcwAddInstance 用来从 PCW_DATA 数组描述的数据块中提取计数器值。