开发者
下载

aclrtMemcpyFromSymbol

产品支持情况

产品

是否支持

Ascend 950PR/Ascend 950DT

Atlas A3 训练系列产品/Atlas A3 推理系列产品

Atlas A2 训练系列产品/Atlas A2 推理系列产品

Atlas 200I/500 A2 推理产品

Atlas 推理系列产品

Atlas 训练系列产品

功能说明

实现Device变量数据到Host的同步内存复制,以便读取Device变量中的数据。

本接口为封装接口,仅适用于C++程序,接口内部调用C接口aclrtMemcpyFromSymbol

函数原型

1
2
template <typename T>
aclError aclrtMemcpyFromSymbol(void *dst, size_t dstMax, const T &symbol, size_t count, size_t offset, aclrtMemcpyKind kind)

参数说明

参数名

输入/输出

说明

dst

输入

目的内存地址指针。

dstMax

输入

dst内存最大长度,单位Byte。

需满足dstMax≥count。

symbol

输入

Device变量名。

此处的Device变量通过__gm__方式声明的变量。

count

输入

内存复制的长度,单位Byte。

需满足 offset + count ≤ Device变量大小,Device变量大小可通过aclrtGetSymbolSize接口查询获取。

offset

输入

Device变量地址偏移,单位Byte。

需满足 offset + count ≤ Device变量大小,Device变量大小可通过aclrtGetSymbolSize接口查询获取。

kind

输入

内存复制的类型。类型定义请参见aclrtMemcpyKind

本接口仅支持ACL_MEMCPY_DEVICE_TO_HOST和ACL_MEMCPY_DEFAULT。

返回值说明

返回0表示成功,返回其他值表示失败,请参见aclError

约束说明

aclrtGetSymbolAddress接口中的约束保持一致。