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

#### 产品支持情况

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


#### 功能说明

设置N:M场景下返回的topK结果数量的最大值，如果不设置，默认topK结果数量的最大值为500。

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


#### 函数原型

```
aclError aclfvSetNMTopNum(aclfvInitPara *initPara, uint32_t maxTopNumForNM)
```


#### 参数说明

| 参数名 | 输入/输出 | 说明 |
| --- | --- | --- |
| initPara | 输入&输出 | 特征向量检索初始化参数的指针。 需提前调用aclfvCreateInitPara接口创建aclfvInitPara类型的数据。 |
| maxTopNumForNM | 输入 | N:M场景下返回的topK结果的最大值，取值范围：[500,4800]。 |


#### 返回值说明

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