---
title: aclfvRepoAdd
description: "| 产品 | 是否支持 |"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/others/fvsearch/aclcppdevg_03_1337.html
sourcePath: /source/zh/canncommercial/900/others/fvsearch/aclcppdevg_03_1337.html
indexId: 234a1800e76d432a28fd68d050407b8e144537a30561378e198a31f241074db969
---
# aclfvRepoAdd

#### 产品支持情况

| 产品 | 是否支持 |
| --- | --- |
| Atlas 350 加速卡 | ☓ |
| Atlas A3 训练系列产品 / Atlas A3 推理系列产品 | ☓ |
| Atlas A2 训练系列产品 / Atlas A2 推理系列产品 | ☓ |
| Atlas 200I/500 A2 推理产品 | ☓ |
| Atlas 推理系列产品 | √ |
| Atlas 训练系列产品 | ☓ |


#### 功能说明

添加底库或向已存在底库中添加特征。该章节描述的1:N表示“检索请求的个数:底库的数量”，N:M用于碰撞两个库的相似性。

Atlas 推理系列加速模块产品 不支持本接口。


#### 函数原型

```
aclError aclfvRepoAdd(aclfvSearchType type, aclfvFeatureInfo *featureInfo)
```


#### 参数说明

| 参数名 | 输入/输出 | 说明 |
| --- | --- | --- |
| type | 输入 | 检索类型。类型定义请参见aclfvSearchType。 |
| featureInfo | 输入 | 特征描述信息的指针。类型定义请参见aclfvFeatureInfo。 需提前调用aclfvCreateFeatureInfo接口创建aclfvFeatureInfo类型的数据。 |


#### 返回值说明

返回0表示成功，返回其他值表示失败，请参见aclError。


#### 约束说明

- 1:N添加时，对于每个库，用户需要保证  aclfvFeatureInfo
结构体中的offset连续；N:M添加时，offset不为0会报错。
- 非线程安全，N:M场景不允许多线程同时添加\检索\删除。
- 调用本接口，内部会默认创建一个Stream，用于接口内任务同步执行，在接口执行完成后，该Stream资源会被自动释放。
  受硬件限制，Stream总数有限，请参见aclrtCreateStream(https://www.hiascend.comdocument/detail/zh/canncommercial/900/API/runtimeapi/aclcppdevg_03_0066.html)处的说明。