aclfvCreateSearchInput
aclfvCreateQueryTable
函数功能
创建aclfvQueryTable类型的数据，表示创建检索输入表信息。同步接口。
如需销毁aclfvQueryTable类型的数据，请参见aclfvDestroyQueryTable。
Atlas 200/500 A2推理产品不支持该接口。
函数原型
aclfvQueryTable *aclfvCreateQueryTable(uint32_t queryCnt, uint32_t tableLen, uint8_t *tableData, uint32_t tableDataLen)
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| queryCnt | 输入 | 检索请求数量，1:N场景为1，N:M场景最大1024。 |
| tableLen | 输入 | 单个表长度，长度固定为32KB，系统内部会校验。 |
| tableData | 输入 | 特征值列表的指针，根据特征长度连续存储。 |
| tableDataLen | 输入 | tableData指针申请的内存长度，用于校验。 |
返回值说明
- 返回aclfvQueryTable类型的指针，表示成功。
- 返回nullptr，表示失败。
父主题： aclfvQueryTable
aclfvDestroyQueryTable
函数功能
销毁通过aclfvCreateQueryTable接口创建的aclfvQueryTable类型的数据。同步接口。
Atlas 200/500 A2推理产品不支持该接口。
函数原型
aclError aclfvDestroyQueryTable(aclfvQueryTable *queryTable)
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| queryTable | 输入 | 待销毁的aclfvQueryTable类型的指针。 |
返回值说明
返回0表示成功，返回非0表示失败。
父主题： aclfvQueryTable
aclfvCreateSearchInput
函数功能
创建aclfvSearchInput类型的数据，表示创建检索任务输入信息。同步接口。
如需销毁aclfvSearchInput类型的数据，请参见aclfvDestroySearchInput。
Atlas 200/500 A2推理产品不支持该接口。
函数原型
aclfvSearchInput *aclfvCreateSearchInput(aclfvQueryTable *queryTable, aclfvRepoRange *repoRange, uint32_t topk)
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| queryTable | 输入 | 检索输入表信息的指针。 调用aclfvCreateQueryTable接口创建aclfvQueryTable类型的数据。 |
| repoRange | 输入 | 检索特征库范围的指针。 调用aclfvCreateRepoRange接口创建aclfvRepoRange类型的数据。 |
| topk | 输入 | 单个检索请求需要返回的结果数量。 |
返回值说明
- 返回aclfvSearchInput类型的指针，表示成功。
- 返回nullptr，表示失败。
父主题： aclfvSearchInput
aclfvDestroySearchInput
函数功能
销毁通过aclfvCreateSearchInput接口创建的aclfvSearchInput类型的数据。同步接口。
Atlas 200/500 A2推理产品不支持该接口。
函数原型
aclError aclfvDestroySearchInput(aclfvSearchInput *searchInput)
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| searchInput | 输入 | 待销毁的aclfvSearchInput类型的指针。 |
返回值说明
返回0表示成功，返回非0表示失败。
父主题： aclfvSearchInput
aclfvCreateSearchResult
函数功能
创建aclfvSearchResult类型的数据，表示创建检索结果信息。同步接口。
如需销毁aclfvSearchResult类型的数据，请参见aclfvDestroySearchResult。
Atlas 200/500 A2推理产品不支持该接口。
函数原型
aclfvSearchResult *aclfvCreateSearchResult(uint32_t queryCnt, uint32_t *resultNum, uint32_t resultNumDataLen, uint32_t *id0, uint32_t *id1, uint32_t *resultOffset, float *resultDistance, uint32_t dataLen)
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| queryCnt | 输入 | 检索请求个数，1:N场景为1。 |
| resultNum | 输入 | 结果个数的指针。 每个检索请求的结果个数。 |
| resultNumDataLen | 输入 | resultNum的内存总长度。 |
| id0 | 输入 | 一级库id的指针，总个数为topK*queryCnt。 |
| id1 | 输入 | 二级库id的指针，总个数为topK*queryCnt。 |
| resultOffset | 输入 | 偏移指针。 表示每个检索请求的检索结果对应底库的偏移，总个数为topK*queryCnt。 |
| resultDistance | 输入 | 每个检索结果与检索请求间的距离的指针。 总个数为topK*queryCnt。 |
| dataLen | 输入 | 申请的内存大小，计算公式为：topK*queryCnt*4Byte。 |
返回值说明
- 返回aclfvSearchResult类型的指针，表示成功。
- 返回nullptr，表示失败。
父主题： aclfvSearchResult
aclfvDestroySearchResult
函数功能
销毁通过aclfvCreateSearchResult接口创建的aclfvSearchResult类型的数据。同步接口。
Atlas 200/500 A2推理产品不支持该接口。
函数原型
aclError aclfvDestroySearchResult(aclfvSearchResult *searchResult)
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| searchResult | 输入 | 待销毁的aclfvSearchResult类型的指针。 |
返回值说明
返回0表示成功，返回非0表示失败。
父主题： aclfvSearchResult
在线提单