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 结构的数组中的索引。 在对 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
数组描述的数据块中提取计数器值。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | 在 Windows 7 及更高版本的 Windows 中可用。 |
标头 | wdm.h (包括 Wdm.h、Ntddk.h) |