---
title: 函数：memcpy2d
description: "| 产品 | 是否支持 |"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/runtimeapi/aclpythondevg_01_0122.html
sourcePath: /source/zh/canncommercial/900/API/runtimeapi/aclpythondevg_01_0122.html
indexId: afd9ac58d9374ecb0607ac6784f02b9ac5fb294e627d79d1b703ffd6b6d3334f71
---
# 函数：memcpy2d

#### 产品支持情况

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


#### 功能说明

实现同步内存复制，主要用于矩阵数据的复制。

Atlas 推理系列加速模块产品 不支持该接口。


#### 函数原型

- C函数原型
  1 aclError aclrtMemcpy2d(void *dst, size_t dpitch, const void *src, size_t spitch, size_t width, size_t height, aclrtMemcpyKind kind)

- python函数
  1 ret = acl.rt.memcpy2d(dst, dpitch, src, spitch, width, height, kind)


#### 参数说明

| 参数名 | 说明 |
| --- | --- |
| dst | int，目的内存地址的指针地址。 |
| dpitch | int，目的内存中相邻两列向量的地址距离。 |
| src | int，源内存地址的指针地址。 |
| spitch | int，源内存中相邻两列向量的地址距离。 |
| width | int，待复制的矩阵宽度。 |
| height | int，待复制的矩阵高度。 |
| kind | int，内存复制的类型。 |


#### 返回值说明

| 返回值 | 说明 |
| --- | --- |
| ret | int，错误码，返回0表示成功，返回其它值表示失败。 |


#### 约束说明

- 当前仅支持“ACL_MEMCPY_HOST_TO_DEVICE”类型和“ACL_MEMCPY_DEVICE_TO_HOST”类型的内存复制。
- Atlas 200I/500 A2 推理产品，Ascend RC形态下，不支持调用本接口。