函数：create_data_buffer

产品	是否支持
Atlas A3 训练系列产品/Atlas A3 推理系列产品	√
Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件	√
Atlas 训练系列产品	√
Atlas 推理系列产品	√
Atlas 200I/500 A2 推理产品	√
Atlas 200/300/500 推理产品	√

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

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

C函数原型

aclDataBuffer *aclCreateDataBuffer(void *data, size_t size)

python函数

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，以保障后续业务正常运行。

参数名

说明

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的指针地址。

父主题： aclmdlDataBuffer