__cvta_global_to_generic

产品支持情况

• Ascend 950PR/Ascend 950DT：支持

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

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

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

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

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

功能说明

将Global Memory内存空间的地址值转换为对应的指针并返回。

函数原型

C++

void* __cvta_global_to_generic(size_t rawbits)

参数说明

表1 参数说明

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

返回值说明

指向Global Memory内存空间的指针。该接口不校验输入是否为有效Global Memory地址。异常场景示例说明如下：

输入场景	返回值
rawbits为0	返回指针使用__isGlobal、__isUbuf、__isLocal均判断为0。
rawbits为全1	返回指针使用__isGlobal判断为1，但该指针不是可安全访问的Global Memory地址。

约束说明

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

需要包含的头文件

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

C++

#include "simt_api/device_functions.h"

调用示例

SIMT编程场景：

C++

__global__ __launch_bounds__(1024) void kernel__cvta_global_to_generic(uint32_t* dst, uint64_t addr_val)
{
    int idx = threadIdx.x + blockIdx.x * blockDim.x;
    uint32_t* ptr = static_cast<uint32_t*>(__cvta_global_to_generic(addr_val));
    dst[idx] = ptr[0];
}