aclrtMemcpyAsyncWithDesc

产品支持情况

功能说明

使用内存复制描述符（二级指针方式）进行内存复制。

本接口是异步接口，调用接口成功仅表示任务下发成功，不表示任务执行成功。调用该接口后，需调用同步等待接口（例如，aclrtSynchronizeStream）确保任务已执行完成，否则可能会导致训练或推理等业务异常、Device断链掉卡等未知情况。

本接口需与以下其它关键接口配合使用，以便实现内存复制：

1. 调用aclrtGetMemcpyDescSize接口获取内存描述符所需的内存大小。
2. 申请Device内存，用于存放内存描述符。
3. 申请源内存、目的内存，分别用于存放复制前后的数据。
4. 调用aclrtSetMemcpyDesc接口将源内存地址、目的内存地址等信息设置到内存描述符中。
5. 调用aclrtMemcpyAsyncWithDesc接口实现内存复制。

函数原型

aclError aclrtMemcpyAsyncWithDesc(void *desc, aclrtMemcpyKind kind, aclrtStream stream)

参数说明

返回值说明

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