---
title: GetTaskRatio
description: "| 产品 | 是否支持 |"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/ascendcopapi/atlasascendc_api_07_0188.html
sourcePath: /source/zh/canncommercial/900/API/ascendcopapi/atlasascendc_api_07_0188.html
indexId: 4ba9196476892a2a5e6ee667fc13679a3115d37e050aaf4f60bc1742b07287e976
---
# GetTaskRatio

#### 产品支持情况

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


#### 功能说明

分离模式(https://www.hiascend.comdocument/detail/zh/canncommercial/900/programug/Ascendcopdevg/atlas_ascendc_10_0008.html#ZH-CN_TOPIC_0000002531522198__section1574769433)下，获取一个AI Core上Cube Core（AIC）或者Vector Core（AIV）的数量与AI Core数量的比例。耦合模式下，固定返回1。


#### 函数原型

```
__aicore__ inline int64_t GetTaskRatio()
```


#### 参数说明

无


#### 返回值说明

- 针对  分离模式(https://www.hiascend.comdocument/detail/zh/canncommercial/900/programug/Ascendcopdevg/atlas_ascendc_10_0008.html#ZH-CN_TOPIC_0000002531522198__section1574769433)
，不同Kernel类型下（通过  设置Kernel类型
接口设置），在AIC和AIV上调用该接口的返回值如下：
**表1 返回值列表**

| Kernel类型 | KERNEL\_TYPE\_AIV\_ONLY | KERNEL\_TYPE\_AIC\_ONLY | KERNEL\_TYPE\_MIX\_AIC\_1\_2 | KERNEL\_TYPE\_MIX\_AIC\_1\_1 | KERNEL\_TYPE\_MIX\_AIC\_1\_0 | KERNEL\_TYPE\_MIX\_AIV\_1\_0 |
| --- | --- | --- | --- | --- | --- | --- |
| AIV | 1 | \- | 2 | 1 | \- | 1 |
| AIC | \- | 1 | 1 | 1 | 1 | \- |


- 针对  耦合模式(https://www.hiascend.comdocument/detail/zh/canncommercial/900/programug/Ascendcopdevg/atlas_ascendc_10_0008.html#ZH-CN_TOPIC_0000002531522198__section1574769433)
，固定返回1。


#### 约束说明

无


#### 调用示例

```
uint64_t ratio = AscendC::GetTaskRatio(); // 返回AIC和AIV的数量比例
AscendC::PRINTF("task ratio is %u", ratio);
```
