---
title: aclrtGetDeviceUtilizationRate
description: "| 产品 | 是否支持 |"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/runtimeapi/aclcppdevg_03_0046.html
sourcePath: /source/zh/canncommercial/900/API/runtimeapi/aclcppdevg_03_0046.html
indexId: 9efad4c0b3127e05de2b580c6ee0a5cb71e120b98c74440ddf5cb48f321bdc4668
---
# aclrtGetDeviceUtilizationRate

#### 产品支持情况

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


#### 功能说明

查询Device上Cube、Vector、AI CPU等的利用率。


#### 函数原型

```
aclError aclrtGetDeviceUtilizationRate(int32_t deviceId, aclrtUtilizationInfo *utilizationInfo)
```


#### 参数说明

| 参数名 | 输入/输出 | 说明 |
| --- | --- | --- |
| deviceId | 输入 | Device ID。 用户调用aclrtGetDeviceCount接口获取可用的Device数量后，这个Device ID的取值范围：[0, (可用的Device数量\-1)] |
| utilizationInfo | 输出 | 利用率信息结构体指针。类型定义参见aclrtUtilizationInfo。 |


#### 返回值说明

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


#### 约束说明

- 当使用本接口查询Vector利用率时，如果查询结果为-1，则表示Vector不存在。
- 当前版本不支持查询Device内存利用率，若通过本接口查询内存利用率，返回的利用率为-1。
- 开启Profiling功能时，不支持调用本接口查询利用率，接口返回值无实际意义。
- 昇腾虚拟化实例场景下，不支持调用本接口查询利用率，接口返回值无实际意义。