lwpins32、lwpins64

项目
08/12/2011

更新：2011 年 3 月

需要 Visual Studio 2010 SP1。

Microsoft 专用

生成轻量分析 (LWP) 指令 lwpins 以将用户事件记录插入活动 LWP 环形缓冲区。

unsigned char __lwpins32(
   unsigned int data2,
   unsigned int data1,
   unsigned int flags
);

unsigned char __lwpins64(
   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 环形缓冲区记录的“标志”字段。

返回值

无符号字符，如果环形缓冲区已满，则值为 1，否则为 0。

要求

内部	体系结构
__llwpins32	LWP
__llwpins64	仅限 LWP、X64

头文件 <intrin.h>

备注

这些内部函数可以使用轻量分析环形缓冲区中的 EventId 255 来记录重要事件。与 lwpval 不同，lwpins 指令在每次被执行时写入缓冲区。有关更多信息，请参见 __lwpval32。

当轻量分析启用时，这些内部函数会立即将记录写入活动 LWP 环缓冲区的下一个可用的槽并返回 0。如果环形缓冲区完整，则新记录会覆盖该缓冲区中的最后一个记录，并且内部函数会返回 1。当轻量分析未启用时，这些内部函数会以静默方式返回 0。

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

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

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