---
title: 函数：create_feature_info
description: "| 产品 | 是否支持 |"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/others/fvsearch/aclpythondevg_01_0835.html
sourcePath: /source/zh/canncommercial/900/others/fvsearch/aclpythondevg_01_0835.html
indexId: 8e2b766d2caf4360d3c740c501de2d42ae53016505f998b0741a533ae2ceaaee72
---
# 函数：create_feature_info

#### 产品支持情况

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


#### 功能说明

创建aclfvFeatureInfo类型的数据，表示创建特征描述信息。

如需销毁aclfvFeatureInfo类型的数据，请参见函数：destroy_feature_info。

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


#### 函数原型

- C函数原型
  1 aclfvFeatureInfo *aclfvCreateFeatureInfo(uint32_t id0, uint32_t id1, uint32_t offset, uint32_t featureLen,uint32_t featureCount, uint8_t *featureData, uint32_t featureDataLen)

- python函数
  1 feature_info = acl.fv.create_feature_info(id0, id1, offset, feature_len, feature_count, feature_data, feature_len)


#### 参数说明

| 参数名 | 说明 |
| --- | --- |
| id0 | int，一级库id，取值范围0\-1023，N:M场景默认为0。通过id0、id1共同确定一个库。 |
| id1 | int，二级库id，取值范围0\-1023，N:M场景默认为0。通过id0、id1共同确定一个库。 |
| offset | int，添加的首个特征在库中的偏移，偏移值需要与库中已添加特征个数一致。N:M场景默认为0。 |
| feature\_len | int，单个特征长度，当前固定为36Byte，系统内部会校验。 |
| feature\_count | int，特征数量，1:N最大100万，N:M最大1000万。 |
| feature\_data | int，特征值，根据特征长度连续存储，每条特征前4Byte值为0。 |
| feature\_len | int，featureData申请的内存长度，用于校验。 |


#### 返回值说明

| 返回值 | 说明 |
| --- | --- |
| feature\_info | int，指针地址。 返回aclfvFeatureInfo类型，表示成功。 返回0，表示失败。 |


#### 资源参考

接口调用流程及示例代码，参见特征向量检索(https://www.hiascend.comdocument/detail/zh/canncommercial/900/programug/acldevg/aclpythondevg_0079.html)。