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

#### 产品支持情况

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


#### 功能说明

创建aclDataBuffer类型的数据，该数据类型用于描述内存地址、大小等内存信息。

如需销毁aclDataBuffer类型的数据，请参见函数：destroy_data_buffer。


#### 函数原型

- C函数原型
  1 aclDataBuffer *aclCreateDataBuffer(void *data, size_t size)

- python函数
  1 output = acl.create_data_buffer(data, size)


#### 参数说明

| 参数名 | 说明 |
| --- | --- |
| data | int，表示存储aclDataBuffer数据的指针地址。“data”参数支持传入0，表示创建一个空的数据类型，此时“size”参数值必须设置为0。 该内存需由用户自行管理，调用acl.rt.malloc接口/acl.rt.free接口申请/释放内存，或调用acl.rt.malloc\_host接口/acl.rt.free\_host接口申请/释放内存。 |
| size | int，内存大小。如果用户需要使用空Tensor，则在申请内存时，内存大小最小为1Byte，以保障后续业务正常运行。 |


#### 返回值说明

| 返回值 | 说明 |
| --- | --- |
| output | int， 输出aclDataBuffer的指针地址。 |