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

#### 产品支持情况

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


#### 功能说明

创建aclfvSearchResult类型的数据，表示创建检索结果信息。

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

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


#### 函数原型

- C函数原型
  1 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)

- python函数
  1 search_result = acl.fv.create_search_result(query_cnt, result_num, result_num_data_len, id_0, id_1, result_offset, result_distance, data_len)


#### 参数说明

| 参数名 | 说明 |
| --- | --- |
| query\_cnt | int，检索请求个数，1:N场景为1。 |
| result\_num | int，每个检索请求的结果个数。 |
| result\_num\_data\_len | int，resultNum的内存总长度。 |
| id\_0 | int，一级库id，总个数为topK\*queryCnt。 |
| id\_1 | int，二级库id，总个数为topK\*queryCnt。 |
| result\_offset | int，偏移指针。 表示每个检索请求的检索结果对应底库的偏移，总个数为topK\*queryCnt。 |
| result\_distance | int，每个检索结果与检索请求间的距离，总个数为topK\*queryCnt。 |
| data\_len | int，申请的内存大小，计算公式为：topK\*queryCnt\*4Byte。 |


#### 返回值说明

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


#### 资源参考

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