开发者
下载

aclrtMemcpyToSymbol

产品支持情况

产品

是否支持

Ascend 950PR/Ascend 950DT

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

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

Atlas 200I/500 A2 推理产品

Atlas 推理系列产品

Atlas 训练系列产品

功能说明

实现Host数据到Device变量的同步内存复制。用于向Device变量写入数据。

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

函数原型

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

参数说明

参数名

输入/输出

说明

symbol

输入

Device变量名。

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

src

输入

源内存地址指针。

count

输入

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

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

offset

输入

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

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

kind

输入

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

本接口仅支持ACL_MEMCPY_HOST_TO_DEVICE和ACL_MEMCPY_DEFAULT。

返回值说明

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

约束说明

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