__cvta_generic_to_ubuf

产品支持情况

• Ascend 950PR/Ascend 950DT：支持

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

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

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

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

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

功能说明

将输入的指针转换为其指向的Unified Buffer内存空间的地址值并返回。

函数原型

C++

size_t __cvta_generic_to_ubuf(const void* ptr)

参数说明

表1 参数说明

参数名	输入/输出	描述
ptr	输入	源操作数。

返回值说明

输入指针指向Unified Buffer内存空间的地址值。 该接口不校验输入地址是否为可安全访问的有效地址。只有当ptr实际指向Unified Buffer内存空间时，返回值是有效的Unified Buffer地址值。特殊场景说明如下：

输入场景	返回值
ptr为Global Memory指针	未定义行为，返回值不是有效Unified Buffer地址。
ptr为nullptr	返回0x00000000fff80000。
ptr为栈空间指针	编译阶段报错。

约束说明

SIMD与SIMT混合编程场景不支持使用该接口。

需要包含的头文件

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

C++

#include "simt_api/device_functions.h"

调用示例

SIMT编程场景：

C++

__global__ __launch_bounds__(1024) void kernel__cvta_generic_to_ubuf(uint32_t* src)
{
    __ubuf__ uint32_t ubuf_data[1024];
    int idx = threadIdx.x + blockIdx.x * blockDim.x;
    ubuf_data[threadIdx.x] = src[idx];
    size_t addr_val = __cvta_generic_to_ubuf(ubuf_data + threadIdx.x);
    if (addr_val > (256-32) * 1024) { // 256:UB总容量，32:Dcache容量
        printf("UB(ubuf_data)溢出，偏移量为：%lu\n", addr_val);
    } else {
        printf("UB(ubuf_data)的偏移量为：%lu\n", addr_val);
    }
}