---
title: aclSetTensorAddr
description: "通过aclSetAclOpExecutorRepeatable使能aclOpExecutor可复用后，若输入或输出Device内存地址变更，需要刷新对应aclTensor中记录的Device内存地址。"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/aolapi/operatorlist_00047.html
sourcePath: /source/zh/canncommercial/900/API/aolapi/operatorlist_00047.html
indexId: 7f07c06d58ab9c8725579bf42ca2757bd20651affffb7070127918c3c045ec9064
---
# aclSetTensorAddr

#### 功能说明

通过aclSetAclOpExecutorRepeatable使能aclOpExecutor可复用后，若输入或输出Device内存地址变更，需要刷新对应aclTensor中记录的Device内存地址。


#### 函数原型

```
aclnnStatus aclSetTensorAddr(aclOpExecutor *executor, const size_t index, aclTensor *tensor, void *addr)
```


#### 参数说明

| 参数名 | 输入/输出 | 说明 |
| --- | --- | --- |
| executor | 输入 | 设置为复用状态的aclOpExecutor。 |
| index | 输入 | 待刷新的aclTensor索引，取值范围是[0, tensor的总数\-1]。 |
| tensor | 输入 | 待刷新的aclTensor指针。 |
| addr | 输入 | 需要刷新到指定aclTensor中的Device存储地址，该地址必须32字节对齐，否则可能会出现未定义错误。 |


#### 返回值说明

返回0表示成功，返回其他值表示失败，返回码列表参见公共接口返回码。

可能失败的原因：

- 返回561103：executor或tensor是空指针。
- 返回161002：index取值越界。
- 返回161002：第一次执行一阶段接口aclxxXxxGetWorkspaceSize时传入的aclTensor是nullptr，不再支持刷新地址。


#### 约束说明

无


#### 调用示例

关键代码示例如下，仅供参考，不支持直接拷贝运行。

```
// 创建输入和输出的aclTensor和aclTensorList
std::vector<int64_t> shape = {1, 2, 3};
aclTensor tensor1 = aclCreateTensor(shape.data(), shape.size(), aclDataType::ACL_FLOAT,
nullptr, 0, aclFormat::ACL_FORMAT_ND, shape.data(), shape.size(), nullptr);
aclTensor tensor2 = aclCreateTensor(shape.data(), shape.size(), aclDataType::ACL_FLOAT,
nullptr, 0, aclFormat::ACL_FORMAT_ND, shape.data(), shape.size(), nullptr);
aclTensor tensor3 = aclCreateTensor(shape.data(), shape.size(), aclDataType::ACL_FLOAT,
nullptr, 0, aclFormat::ACL_FORMAT_ND, shape.data(), shape.size(), nullptr);
aclTensor output = aclCreateTensor(shape.data(), shape.size(), aclDataType::ACL_FLOAT,
nullptr, 0, aclFormat::ACL_FORMAT_ND, shape.data(), shape.size(), nullptr);
aclTensor *list[] = {tensor1, tensor2};
auto tensorList = aclCreateTensorList(list, 2);
uint64_t workspaceSize = 0;
aclOpExecutor *executor;
// AddCustom算子有两个输入（aclTensorList和aclTensor），一个输出（aclTensor）
// 调用第1段接口
aclnnAddCustomGetWorkspaceSize(tensorList, tensor3, output, &workspaceSize, &executor);
// 设置executor为可复用
aclSetAclOpExecutorRepeatable(executor);  
void *addr;
aclSetTensorAddr(executor, 0, tensor1, addr); // 刷新输入tensorList中第1个aclTensor的device地址
aclSetTensorAddr(executor, 1, tensor2, addr); // 刷新输入tensorList中第2个aclTensor的device地址
aclSetTensorAddr(executor, 2, tensor3, addr); // 刷新输入aclTensor的device地址
aclSetTensorAddr(executor, 3, output, addr); // 刷新输出aclTensor的device地址
// 调用第2段接口
aclnnAddCustom(workspace, workspaceSize, executor, stream);
// 清理executor
aclDestroyAclOpExecutor(executor);
```