跳到主要内容

aclGetDataBufferAddr

aclCreateDataBuffer​

函数功能​

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

如需销毁aclDataBuffer类型的数据，请参见aclDestroyDataBuffer。

函数原型​

aclDataBuffer *aclCreateDataBuffer(void *data, size_t size)

参数说明​

参数名输入/输出说明
data输入存放数据内存地址的指针。data参数支持传入nullptr，表示创建一个空的数据类型，此时size参数值无效。 该内存需由用户自行管理，调用aclrtMalloc接口/aclrtFree接口申请/释放内存，或调用aclrtMallocHost接口/aclrtFreeHost接口申请/释放内存。
size输入内存大小，单位Byte。 如果用户需要使用空tensor，则在申请内存时，内存大小最小为1Byte，以保障后续业务正常运行。

返回值说明​

返回aclDataBuffer类型的指针。

父主题： aclDataBuffer

aclDestroyDataBuffer​

函数功能​

销毁通过aclCreateDataBuffer接口创建的aclDataBuffer类型的数据。同步接口。

此处仅销毁aclDataBuffer类型的数据，调用aclCreateDataBuffer接口创建aclDataBuffer类型数据时传入的data的内存需由用户自行释放。

函数原型​

aclError aclDestroyDataBuffer(const aclDataBuffer *dataBuffer)

参数说明​

参数名输入/输出说明
dataBuffer输入待销毁的aclDataBuffer类型的指针。

返回值说明​

返回0表示成功，返回非0表示失败。

父主题： aclDataBuffer

aclGetDataBufferAddr​

函数功能​

获取aclDataBuffer类型中的数据的内存地址。同步接口。

函数原型​

void *aclGetDataBufferAddr(const aclDataBuffer *dataBuffer)

参数说明​

参数名输入/输出说明
dataBuffer输入aclDataBuffer类型的指针。 需提前调用aclCreateDataBuffer接口创建aclDataBuffer类型的数据。

返回值说明​

返回aclDataBuffer类型中的数据的内存地址。

父主题： aclDataBuffer

aclGetDataBufferSize​

备注

须知

此接口后续版本会废弃，请使用aclGetDataBufferSizeV2接口。

函数功能​

获取aclDataBuffer类型中数据的内存大小，单位Byte。同步接口。

函数原型​

uint32 aclGetDataBufferSize(const aclDataBuffer *dataBuffer)

参数说明​

参数名输入/输出说明
dataBuffer输入aclDataBuffer类型的指针。 需提前调用aclCreateDataBuffer接口创建aclDataBuffer类型的数据。

返回值说明​

aclDataBuffer类型中数据的内存大小。

父主题： aclDataBuffer

aclGetDataBufferSizeV2​

函数功能​

获取aclDataBuffer类型中数据的内存大小，单位Byte。同步接口。

函数原型​

size_t aclGetDataBufferSizeV2(const aclDataBuffer *dataBuffer)

参数说明​

参数名输入/输出说明
dataBuffer输入aclDataBuffer类型的指针。 需提前调用aclCreateDataBuffer接口创建aclDataBuffer类型的数据。

返回值说明​

aclDataBuffer类型中数据的内存大小。

父主题： aclDataBuffer

aclUpdateDataBuffer​

函数功能​

更新aclDataBuffer中数据的内存及大小。同步接口。

更新aclDataBuffer后，之前aclDataBuffer中存放数据的内存如果不使用，需及时释放，否则可能会导致内存泄漏。

函数原型​

aclError aclUpdateDataBuffer(aclDataBuffer *dataBuffer, void *data, size_t size)

参数说明​

参数名输入/输出说明
dataBuffer输入aclDataBuffer类型的指针。 需提前调用aclCreateDataBuffer接口创建aclDataBuffer类型的数据。 该内存需由用户自行管理，调用aclrtMalloc接口/aclrtFree接口申请/释放内存，或调用aclrtMallocHost接口/aclrtFreeHost接口申请/释放内存。
data输入存放数据内存地址的指针。
size输入内存大小，单位Byte。 如果用户需要使用空tensor，则在申请内存时，内存大小最小为1Byte，以保障后续业务正常运行。

返回值说明​

返回0表示成功，返回非0表示失败。

父主题： aclDataBuffer

在线提单