---
title: SetLoadDataRepeat
description: "| 产品 | 是否支持 |"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/ascendcopapi/atlasascendc_api_07_0247.html
sourcePath: /source/zh/canncommercial/900/API/ascendcopapi/atlasascendc_api_07_0247.html
indexId: 2fccdc0cec47d9c93a30cb77840e5229726a9fa4c2759b457d1842648ebf652676
---
# SetLoadDataRepeat

#### 产品支持情况

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


#### 功能说明

用于设置Load3Dv2接口的repeat参数。设置repeat参数后，可以通过调用一次Load3Dv2接口完成多个迭代的数据搬运。


#### 函数原型

```
__aicore__ inline void SetLoadDataRepeat(const LoadDataRepeatParam& repeatParams)
```


#### 参数说明


**表1 参数说明**

| 参数名称 | 输入/输出 | 含义 |
| --- | --- | --- |
| repeatParams | 输入 | 设置Load3Dv2接口的repeat参数，类型为LoadDataRepeatParam。 具体定义请参考${INSTALL\_DIR}/include/ascendc/basic\_api/interface/kernel\_struct\_mm.h，${INSTALL\_DIR}请替换为CANN软件安装后文件存储路径。 参数说明请参考表2。 |


**表2 LoadDataRepeatParam结构体参数说明**

| 参数名称 | 含义 |
| --- | --- |
| repeatTime | height/width方向上的迭代次数，取值范围：repeatTime ∈[0, 255] 。默认值为1。 |
| repeatStride | height/width方向上的前一个迭代与后一个迭代起始地址的距离，取值范围：[0, 65535]，默认值为0。 repeatMode为0，repeatStride的单位为16个元素。 repeatMode为1，repeatStride的单位和具体型号有关。下文中的data\_type指Load3Dv2中源操作数的数据类型。 Atlas 350 加速卡，repeatStride的单位为32/sizeof(data\_type)个元素 。 Atlas A2 训练系列产品 / Atlas A2 推理系列产品 ，repeatStride的单位为32/sizeof(data\_type)个元素 。 Atlas A3 训练系列产品 / Atlas A3 推理系列产品 ，repeatStride的单位为32/sizeof(data\_type)个元素 。 Atlas 200I/500 A2 推理产品 ，repeatStride的单位为64/sizeof(data\_type)个元素。 |
| repeatMode | 控制repeat迭代的方向，取值范围：[0, 1] 。默认值为0。 0：迭代沿height方向； 1：迭代沿width方向。 |


#### 调用示例

参考调用示例