昇腾社区首页
中文
注册

函数:set_memcpy_desc

产品支持情况

产品

是否支持

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

Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件

Atlas 训练系列产品

x

Atlas 推理系列产品

x

Atlas 200I/500 A2 推理产品

Atlas 200/300/500 推理产品

x

功能说明

设置内存复制描述符,此接口调用完成后,会将源地址,目的地址、内存复制长度记录到内存复制描述符中。

本接口需与其它关键接口配合使用,以便实现内存复制,详细描述请参见acl.rt.memcpy_async_with_desc

函数原型

  • C函数原型
    1
    aclError aclrtSetMemcpyDesc(void *desc, aclrtMemcpyKind kind, void *srcAddr, void *dstAddr, size_t count, void *config)
    
  • python函数
    1
    desc, ret = acl.rt.set_memcpy_desc(desc, kind, src_addr, dst_addr, count, config)
    

参数说明

参数名

说明

desc

int,内存复制描述符地址指针。

需先调用acl.rt.get_memcpy_desc_size接口获取内存描述符所需的内存大小,再申请Device内存后(例如acl.rt.malloc接口),将Device内存地址作为入参传入此处

kind

int,内存复制的类型。当前仅支持ACL_MEMCPY_INNER_DEVICE_TO_DEVICE,表示Device内的内存复制。

src_addr

int,源内存地址指针。由用户申请内存并管理内存。

dst_addr

int,目的内存地址指针。由用户申请内存并管理内存。

count

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

config

int,预留参数,当前固定传0。

返回值说明

返回值

说明

desc

int,内存复制描述符地址指针。

ret

int,错误码,返回0表示成功,返回其它值表示失败。