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
。 将记录数组中的信息,并将由 PcwCreateInstance
或 PcwAddInstance
用于从数组描述 PCW_DATA
的数据块中提取计数器值。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 在 Windows 7 和更高版本的 Windows 中可用。 |
标头 | wdm.h (包括 Wdm.h、Ntddk.h) |