Skip to main content

aclfvDestroySearchInput

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

aclfvCreateInitPara​

函数功能​

创建aclfvInitPara类型的数据，表示创建特征向量检索的初始化参数。同步接口。

如需销毁aclfvInitPara类型的数据，请参见aclfvDestroyInitPara。

Atlas 200/500 A2推理产品不支持该接口。

函数原型​

aclfvInitPara *aclfvCreateInitPara(uint64_t fsNum)

参数说明​

参数名输入/输出说明
fsNum输入底库特征个数，用于系统内部给特征检索模块申请内存资源。 取值范围：[1,500000000]

返回值说明​

  • 返回aclfvInitPara类型的指针，表示成功。
  • 返回nullptr，表示失败。

父主题： aclfvInitPara

在线提单