---
title: aclrtSetBufDataLen
description: "设置共享Buffer中有效数据的长度。"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/runtimeapi/aclcppdevg_03_1908.html
sourcePath: /source/zh/canncommercial/900/API/runtimeapi/aclcppdevg_03_1908.html
indexId: 4e8e0101b53ce3fdb17fcf0cb7e659243d2411de4a50d2d436aed98815d8d70968
---
# aclrtSetBufDataLen

#### 功能说明

设置共享Buffer中有效数据的长度。

接口调用顺序：调用aclrtAllocBuf或aclrtCopyBufRef接口申请到共享Buffer后，因此需由用户调用aclrtGetBufData接口获取共享Buffer的内存指针及长度后，再自行向内存中填充有效数据，然后再调用aclrtSetBufDataLen接口设置共享Buffer中有效数据的长度，且长度必须小于aclrtGetBufData获取到的size大小。


#### 函数原型

```
aclError aclrtSetBufDataLen(aclrtMbuf buf, size_t len)
```


#### 参数说明

| 参数名 | 输入/输出 | 说明 |
| --- | --- | --- |
| buf | 输入 | 共享Buffer，类型定义请参见aclrtMbuf。 须通过aclrtAllocBuf或aclrtCopyBufRef接口申请获得。 |
| len | 输入 | 有效数据的长度，单位为Byte。 |


#### 返回值说明

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