aclGetDataBufferSize
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
aclmdlCreateDataset
函数功能
创建aclmdlDataset类型的数据，该数据类型用于描述模型推理时的输入数据、输出数据，模型可能存在多个输入、多个输出，每个输入/输出的内存地址、内存大小用aclDataBuffer类型的数据来描述。同步接口。
如需销毁aclmdlDataset类型的数据，请参见aclmdlDestroyDataset。
函数原型
aclmdlDataset *aclmdlCreateDataset()
参数说明
无
返回值说明
返回aclmdlDataset类型的指针。
父主题： aclmdlDataset
在线提单