lanemask_eq

产品支持情况

• Ascend 950PR/Ascend 950DT：支持

• Atlas A3 训练系列产品/Atlas A3 推理系列产品：不支持

• Atlas A2 训练系列产品/Atlas A2 推理系列产品：不支持

• Atlas 200I/500 A2 推理产品：不支持

• Atlas 推理系列产品AI Core：不支持
• Atlas 推理系列产品Vector Core：不支持

• Atlas 训练系列产品：不支持

功能说明

获取当前线程的一个32位掩码，在当前线程所属的Warp中，只有当前线程所在的Lane位被置为1，其余位为0。

如Lane ID为0的线程，调用本接口获取到32位掩码：0000 0000 0000 0000 0000 0000 0000 0001。

如Lane ID为31的线程，调用本接口获取到32位掩码：1000 0000 0000 0000 0000 0000 0000 0000。

图1 lanemask_eq示意图

函数原型

C++

int32_t lanemask_eq()

参数说明

无

返回值说明

返回一个32位整数的位掩码。

约束说明

无

需要包含的头文件

使用该接口需要包含"simt_api/device_functions.h"头文件。

C++

#include "simt_api/device_functions.h"

调用示例

下面示例使用lanemask_eq获取当前Lane对应的位掩码，并根据掩码将Warp内偶数Lane和奇数Lane的数据分别重排到输出Warp的前16个位置和后16个位置。示例中使用asc_shfl，需另外包含"simt_api/device_warp_functions.h"头文件，其中srcLane的取值范围为[0, 15]。

• SIMT编程场景：

  C++

  __global__ __launch_bounds__(1024) void kernel_lanemask_eq(int32_t* dst, int32_t* src, int32_t srcLane)
  {
      int idx = threadIdx.x + blockIdx.x * blockDim.x;
      int32_t self_mask = lanemask_eq();
      int32_t group_leader_lane = ((self_mask & 0x0000FFFFU) != 0) ? srcLane : (srcLane + 16);
      int32_t value = src[idx];
      value = asc_shfl(value, group_leader_lane, 32);
      dst[idx] = value;
  }
  

• SIMD与SIMT混合编程场景：

  C++

  __simt_vf__ __launch_bounds__(1024) void kernel_lanemask_eq(__gm__ int32_t* dst, __gm__ int32_t* src, int32_t srcLane)
  {
      int idx = threadIdx.x + blockIdx.x * blockDim.x;
      int32_t self_mask = lanemask_eq();
      int32_t group_leader_lane = ((self_mask & 0x0000FFFFU) != 0) ? srcLane : (srcLane + 16);
      int32_t value = src[idx];
      value = asc_shfl(value, group_leader_lane, 32);
      dst[idx] = value;
  }