wdm.h) (PCW_COUNTER_DESCRIPTOR 结构

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

Offset

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

Size

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

注解

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

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

要求

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

另请参阅

_PCW_REGISTRATION_INFORMATION 结构

_PCW_DATA结构

CTRPP

计数器复杂类型