aclDataBuffer
aclCreateDataBuffer
函数功能
创建aclDataBuffer类型的数据，该数据类型用于描述内存地址、大小等内存信息。同步接口。
如需销毁aclDataBuffer类型的数据，请参见aclDestroyDataBuffer。
函数原型
aclDataBuffer *aclCreateDataBuffer(void *data, size_t size)
参数说明
参数名 |
输入/输出 |
说明 |
|---|---|---|
data |
输入 |
存放数据的内存地址。 该内存需由用户自行管理，调用aclrtMalloc接口/aclrtFree接口申请/释放内存，或调用aclrtMallocHost接口/aclrtFreeHost接口申请/释放内存。 |
size |
输入 |
内存大小，单位Byte。 如果用户需要使用空tensor，则在申请内存时，内存大小最小为1Byte。 |
返回值说明
返回aclDataBuffer类型的指针。
aclDestroyDataBuffer
函数功能
销毁通过aclCreateDataBuffer接口创建的aclDataBuffer类型的数据。同步接口。
此处仅销毁aclDataBuffer类型的数据，调用aclCreateDataBuffer接口创建aclDataBuffer类型数据时传入的data的内存需由用户自行释放。
函数原型
aclError aclDestroyDataBuffer(const aclDataBuffer *dataBuffer)
参数说明
参数名 |
输入/输出 |
说明 |
|---|---|---|
dataBuffer |
输入 |
待销毁的aclDataBuffer类型的指针。 |
返回值说明
返回0表示成功，返回非0表示失败。
aclGetDataBufferAddr
函数功能
获取aclDataBuffer类型中的数据的内存地址。同步接口。
函数原型
void *aclGetDataBufferAddr(const aclDataBuffer *dataBuffer)
参数说明
参数名 |
输入/输出 |
说明 |
|---|---|---|
dataBuffer |
输入 |
aclDataBuffer类型的指针。 需提前调用aclCreateDataBuffer接口创建aclDataBuffer类型的数据。 |
返回值说明
返回aclDataBuffer类型中的数据的内存地址。
aclGetDataBufferSize
此接口后续版本会废弃，请使用aclGetDataBufferSizeV2接口。
函数功能
获取aclDataBuffer类型中数据的内存大小，单位Byte。同步接口。
函数原型
uint32 aclGetDataBufferSize(const aclDataBuffer *dataBuffer)
参数说明
参数名 |
输入/输出 |
说明 |
|---|---|---|
dataBuffer |
输入 |
aclDataBuffer类型的指针。 需提前调用aclCreateDataBuffer接口创建aclDataBuffer类型的数据。 |
返回值说明
aclDataBuffer类型中数据的内存大小。
aclGetDataBufferSizeV2
函数功能
获取aclDataBuffer类型中数据的内存大小，单位Byte。同步接口。
函数原型
size_t aclGetDataBufferSizeV2(const aclDataBuffer *dataBuffer)
参数说明
参数名 |
输入/输出 |
说明 |
|---|---|---|
dataBuffer |
输入 |
aclDataBuffer类型的指针。 需提前调用aclCreateDataBuffer接口创建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表示失败。
