---
title: dcmi_get_device_multi_utilization_rate_period
description: "int dcmi_get_device_multi_utilization_rate_period (int card_id, int device_id, struct dcmi_multi_utilization_info *util_info, int period)"
url: https://www.hiascend.com/document/detail/zh/HDK/latest/A2/A2DCMI/dcmi_057.html
sourcePath: /source/zh/HDK/2610/A2/A2DCMI/dcmi_057.html
indexId: abbcf9e182ff1cb2669f8c7ea44abfd42614e04982ee8e832e10cf69f3157d4743
---
# dcmi_get_device_multi_utilization_rate_period

#### 函数原型

int dcmi_get_device_multi_utilization_rate_period (int card_id, int device_id, struct dcmi_multi_utilization_info *util_info, int period)


#### 功能说明

获取指定时间内芯片的平均占用率。


#### 参数说明

| 参数名称 | 输入/输出 | 类型 | 描述 |
| --- | --- | --- | --- |
| card\_id | 输入 | int | 设备ID，当前实际支持的ID通过dcmi\_get\_card\_list接口获取。 |
| device\_id | 输入 | int | 芯片ID，通过dcmi\_get\_device\_id\_in\_card接口获取。取值范围如下： NPU芯片：[0, device\_id\_max\-1]。 说明： device\_id\_max值为1，当device\_id为0时表示NPU芯片；当device\_id为1时表示MCU芯片。 |
| util\_info | 输出 | struct dcmi\_multi\_utilization\_info \* | 返回AI Cube利用率、AI vector利用率、AI Core利用率和NPU整体利用率。 \#define DCMI\_UTIL\_RESERVED\_LEN 8 struct dcmi\_multi\_utilization\_info { unsigned int aic\_util; unsigned int aiv\_util; unsigned int aicore\_util; unsigned int npu\_util; unsigned int reserved[DCMI\_UTIL\_RESERVED\_LEN]; //预留参数 }; |
| period | 输入 | int | 指定时间，单位s，取值范围为[1, 4]。 |


#### 返回值说明

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


#### 异常处理

无。


#### 约束说明

- A300I A2 推理卡的片上内存为32G，无业务时系统占用3G。
- Atlas 800T A2 训练服务器、Atlas 200T A2 Box16 异构子框的片上内存为64G，无业务时系统占用4G。
- Atlas 900 A2 PoD 集群基础单元、A200I A2 Box 异构组件、Atlas 800I A2 推理服务器的片上内存为32G或64G，无业务时系统占用3G或4G。

- 该命令支持在物理机+特权容器场景使用。


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

| 产品形态 | 物理机场景（裸机）root用户 | 物理机场景（裸机）运行用户组（非root用户） | 物理机+普通容器场景root用户 | 物理机+容器AVI场景root用户 |
| --- | --- | --- | --- | --- |
| Atlas 900 A2 PoD 集群基础单元 | Y | Y | Y | Y |
| Atlas 800T A2 训练服务器 | Y | Y | Y | Y |
| Atlas 800I A2 推理服务器 | Y | Y | Y | Y |
| Atlas 200T A2 Box16 异构子框 | Y | Y | Y | Y |
| A200I A2 Box 异构组件 | Y | Y | Y | Y |
| A300I A2 推理卡 | Y | Y | Y | Y |
| 注：Y表示支持；N表示不支持；NA表示不涉及，当前未规划此场景。 | 注：Y表示支持；N表示不支持；NA表示不涉及，当前未规划此场景。 | 注：Y表示支持；N表示不支持；NA表示不涉及，当前未规划此场景。 | 注：Y表示支持；N表示不支持；NA表示不涉及，当前未规划此场景。 | 注：Y表示支持；N表示不支持；NA表示不涉及，当前未规划此场景。 |


#### 调用示例

```
int ret = 0;
int card_id = 0x3;
int device_id = 0;
struct dcmi_multi_utilization_info util_info = {0};
int period = 1;
ret = dcmi_get_device_multi_utilization_rate_period(card_id, device_id, &util_info, period);
if (ret != 0){
//todo：记录日志
return ret;
}
```