---
title: dcmi_get_all_device_count
description: "int dcmi_get_all_device_count(int *all_device_count)"
url: https://www.hiascend.com/document/detail/zh/HDK/latest/A3/A3DCMI/dcmia3_127.html
sourcePath: /source/zh/HDK/2610/A3/A3DCMI/dcmia3_127.html
indexId: 2eea8c71125a9e6c866f62caf268bc0a64ed59380f7acda72f3ade7ac043a1e845
---
# dcmi_get_all_device_count

#### 函数原型

int dcmi_get_all_device_count(int *all_device_count)


#### 功能说明

host启动后，查询与host PCIe建链成功的昇腾AI处理器设备个数。


#### 参数说明

| 参数名称 | 输入/输出 | 类型 | 描述 |
| --- | --- | --- | --- |
| all\_device\_count | 输出 | int \* | 查询到的设备个数。 |


#### 返回值说明

| 类型 | 描述 |
| --- | --- |
| int | 处理结果： 成功：返回0。 失败：返回码请参见返回码。 |


#### 异常处理

无。


#### 约束说明

调用该接口前NPU固件和NPU驱动的安装升级必须生效。


**表1 不同部署场景下的支持情况**

| 产品形态 | 物理机场景（裸机）root用户 | 物理机场景（裸机）运行用户组（非root用户） | 物理机+普通容器场景root用户 | 物理机+容器AVI场景root用户 |
| --- | --- | --- | --- | --- |
| Atlas 900 A3 SuperPoD 超节点 | Y | Y | N | NA |
| Atlas 9000 A3 SuperPoD 集群算力系统 | Y | Y | N | NA |
| Atlas 800T A3 超节点 | Y | Y | N | N |
| Atlas 800I A3 系列硬件产品 | Y | Y | N | N |
| A200T A3 Box8 系列硬件产品 | Y | Y | N | NA |
| 注：Y表示支持；N表示不支持；NA表示不涉及，当前未规划此场景。 | 注：Y表示支持；N表示不支持；NA表示不涉及，当前未规划此场景。 | 注：Y表示支持；N表示不支持；NA表示不涉及，当前未规划此场景。 | 注：Y表示支持；N表示不支持；NA表示不涉及，当前未规划此场景。 | 注：Y表示支持；N表示不支持；NA表示不涉及，当前未规划此场景。 |


#### 调用示例

```
int ret = 0;
int all_device_count;
ret = dcmi_get_all_device_count(&all_device_count);
if(ret != 0) {
//todo
return ret;
}
…
```