lwpval32、lwpval64

项目
08/12/2011

更新：2011 年 3 月

需要 Visual Studio 2010 SP1。

Microsoft 专用

生成轻量分析 (LWP) 指令 lwpval 以将值示例记录插入活动 LWP 环形缓冲区。

void __lwpval32(
   unsigned int data2,
   unsigned int data1,
   unsigned int flags
);

void __lwpval64(
   unsigned __int64 data2,
   unsigned int data1,
   unsigned int flags
);

参数

[in] data2
32 或 64 位参数，将被写入 LWP 环形缓冲区记录的 Data2 字段。
[in] data1
32 位参数，将被写入 LWP 环形缓冲区记录的 Data1 字段。
[in] flags
32 位参数，其中后 16 位参数将被写入 LWP 环形缓冲区记录的“标志”字段。

返回值

无。

要求

内部	体系结构
__lwpval32	LWP
__lwpval64	仅限 LWP、X64

头文件 <intrin.h>

备注

这些内部函数可以使用轻量分析环形缓冲区中的 EventId 1 来记录值示例。与 lwpins 不同，lwpval 指令只在每第 k 次执行 lwpval 时写入该缓冲区，其中 k-1 是 LWPCB 的 EventInterval 字段的值。有关更多信息，请参见 __lwpins32。

当写好记录后，它会进入活动 LWP 环缓冲区的下一个可用的槽。如果环形缓冲区完整，则新记录会覆盖该缓冲区中的最后一个记录。当轻量分析未启用或 LWP 已启用，但编程的值示例事件未启用时，这些内部函数对环形缓冲区不会产生任何作用。

这两个 __lwpval32 和 __lwpval64 将 data2 的值写入环形缓冲区记录的 Data2 字段（23-16 个字节），将 data1 写入 Data1 字段（7-4 个字节），并将 flags 写入“标志”字段（3-2 个字节）。请注意，flags 必须是常数，并且将被截断为 16 位。 __lwpval32 内部函数将具有 23-20 个字节的环形缓冲区记录设置为零。

lwpval 指令是 LWP 系列指令的一部分。LWP 指令要求有对硬件和操作系统两者的支持。若要确定 LWP 的硬件支持，调用 InfoType = 0x80000001 的 __cpuid 内部函数并检查 CPUInfo[2] (ECX) 位 15。当 LWP 受支持时，此位为 1，否则为 0。一旦您了解到处理器支持 LWP，即可调用 InfoType= 0x8000001C 的 __cpuid 内部函数并检查 CPUInfo[0](EAX) 的位 0。如果操作系统还支持 LWP，则此位为 1；否则为 0。如果操作系统不支持 LWP，则检查 CPUInfo[0](EAX) 的位 1，如果 LWPVAL 指令可用，则该位为 1。此 __cpuid 测试还会返回其他有关该 LWP 实现的信息。有关更多消息，请参见 __llwpcb 和 AMD 的“Lightweight Profiling Specification”（轻量分析规范，出版物编号 43724）。

有关示例，请参见**__llwpcb**。