aclfvInitPara
aclfvCreateInitPara
函数功能
创建aclfvInitPara类型的数据，表示创建特征向量检索的初始化参数。同步接口。
如需销毁aclfvInitPara类型的数据，请参见aclfvDestroyInitPara。
昇腾310 AI处理器不支持该接口。
昇腾910 AI处理器不支持该接口。
函数原型
aclfvInitPara *aclfvCreateInitPara(uint64_t fsNum)
参数说明
参数名 |
输入/输出 |
说明 |
|---|---|---|
fsNum |
输入 |
底库特征个数，用于系统内部给特征检索模块申请内存资源。 取值范围：[1,500000000] |
返回值说明
- 返回aclfvInitPara类型的指针，表示成功。
- 返回nullptr，表示失败。
aclfvDestroyInitPara
函数原型
aclError aclfvDestroyInitPara(aclfvInitPara *initPara)
参数说明
参数名 |
输入/输出 |
说明 |
|---|---|---|
initPara |
输入 |
待销毁的aclfvInitPara类型的指针。 |
返回值说明
返回0表示成功，返回非0表示失败。
aclfvSet1NTopNum
函数功能
设置1:N场景下返回的topK结果数量的最大值，如果不设置，默认topK结果数量的最大值为4800。同步接口。
昇腾310 AI处理器不支持该接口。
昇腾910 AI处理器不支持该接口。
函数原型
aclError aclfvSet1NTopNum(aclfvInitPara *initPara, uint32_t maxTopNumFor1N)
参数说明
参数名 |
输入/输出 |
说明 |
|---|---|---|
initPara |
输入&输出 |
指定特征向量检索的初始化参数。 需提前调用aclfvCreateInitPara接口创建aclfvInitPara类型的数据。 |
maxTopNumFor1N |
输入 |
1:N场景下返回的topK结果的最大值，取值范围：[2,4800]。 |
返回值说明
返回0表示成功，返回非0表示失败。
aclfvSetNMTopNum
函数功能
设置N:M场景下返回的topK结果数量的最大值，如果不设置，默认topK结果数量的最大值为500。同步接口。
昇腾310 AI处理器不支持该接口。
昇腾910 AI处理器不支持该接口。
函数原型
aclError aclfvSetNMTopNum(aclfvInitPara *initPara, uint32_t maxTopNumForNM)
参数说明
参数名 |
输入/输出 |
说明 |
|---|---|---|
initPara |
输入&输出 |
指定特征向量检索的初始化参数。 需提前调用aclfvCreateInitPara接口创建aclfvInitPara类型的数据。 |
maxTopNumForNM |
输入 |
N:M场景下返回的topK结果的最大值，取值范围：[500,4800]。 |
返回值说明
返回0表示成功，返回非0表示失败。
