下载
中文
注册

dcmi_get_qpn_list接口原型

函数原型

int dcmi_get_qpn_list (int card_id, int device_id, int port_id, struct dcmi_qpn_list *list)

功能说明

获取qp的数量和对应的qpn_list。

参数说明

参数名称

输入/输出

类型

描述

card_id

输入

int

指定NPU管理单元ID,当前实际支持的ID通过dcmi_get_card_list接口获取。

device_id

输入

int

指定设备编号,通过dcmi_get_device_id_in_card接口获取。取值范围如下:

NPU芯片:[0, device_id_max-1]。

port_id

输入

int

NPU设备的网口端口号,当前仅支持配置0。

list

输出

struct dcmi_qpn_list*

#define MAX_QPN_NUM 8192//qpn列表最大支持的条数

struct dcmi_qpn_list {

unsigned int qp_num;//获取到active状态的qp的数量

unsigned int qpn_list[MAX_QPN_NUM];//与qp_num对应的qpn列表

};

qpn:表示qp number。

返回值

类型

描述

int

处理结果:

  • 成功:返回0。
  • 失败:返回码请参见返回码

异常处理

无。

约束说明

表1 部署场景

Linux物理机

Linux物理机容器

root用户

运行用户组(非root用户)

root用户

N

N

N

调用示例

… 
int ret = 0;
int card_id = 0;
int device_id = 0;
int port_id = 0;
struct dcmi_qpn_list list = {0}; 
ret = dcmi_get_qpn_list(card_id, device_id, port_id, &list);
if (ret != 0){
    //todo:记录日志
    return ret;
}
…