aclrtGetDeviceUtilizationRate

产品	是否支持
Atlas A3 训练系列产品/Atlas A3 推理系列产品	√
Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件	√
Atlas 200I/500 A2 推理产品	√
Atlas 推理系列产品	√
Atlas 训练系列产品	√
Atlas 200/300/500 推理产品	√

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

aclError aclrtGetDeviceUtilizationRate(int32_t deviceId, aclrtUtilizationInfo *utilizationInfo)

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

参数名

输入/输出

说明

deviceId

输入

Device ID。

用户调用aclrtGetDeviceCount接口获取可用的Device数量后，这个Device ID的取值范围：[0, (可用的Device数量-1)]

utilizationInfo

输出

利用率信息结构体指针。

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

查询Device内存利用率为预留功能，当前版本不支持，若调用本接口查询内存利用率，查询到的利用率为-1。
对于以下没有Vector的产品，调用本接口查询Vector利用率时，查询到的利用率为-1。
Atlas 训练系列产品

Atlas 200/300/500 推理产品
昇腾虚拟化实例场景下，不支持调用本接口查询利用率，接口返回值无实际意义。
开启Profiling功能时，不支持调用本接口查询利用率，接口返回值无实际意义。

父主题： Device管理