---
title: aclrtMemcpyAsyncWithDesc
description: "| 产品 | 是否支持 |"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/runtimeapi/aclcppdevg_03_1800.html
sourcePath: /source/zh/canncommercial/900/API/runtimeapi/aclcppdevg_03_1800.html
indexId: 7987e5217f27a5ea9f703de63bc4e558e642496b11887419cdd66cc8277a160a68
---
# aclrtMemcpyAsyncWithDesc

#### 产品支持情况

| 产品 | 是否支持 |
| --- | --- |
| Atlas 350 加速卡 | √ |
| Atlas A3 训练系列产品 / Atlas A3 推理系列产品 | √ |
| Atlas A2 训练系列产品 / Atlas A2 推理系列产品 | √ |
| Atlas 200I/500 A2 推理产品 | √ |
| Atlas 推理系列产品 | ☓ |
| Atlas 训练系列产品 | ☓ |


#### 功能说明

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

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

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


#### 函数原型

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


#### 参数说明

| 参数名 | 输入/输出 | 说明 |
| --- | --- | --- |
| desc | 输入 | 内存复制描述符地址指针，Device侧内存地址。 此处需先调用aclrtSetMemcpyDesc接口设置内存复制描述符，再将内存复制描述符地址指针作为入参传入本接口。 |
| kind | 输入 | 内存复制的类型。类型定义请参见aclrtMemcpyKind。 当前仅支持ACL\_MEMCPY\_INNER\_DEVICE\_TO\_DEVICE，表示Device内的内存复制。 |
| stream | 输入 | 指定执行内存复制任务的Stream。类型定义请参见aclrtStream。 |


#### 返回值说明

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