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

#### 产品支持情况

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


#### 功能说明

指定当前运算使用哪个Group的算力，该接口必须在指定Context后调用。


#### 函数原型

```
aclError aclrtSetGroup(int32_t groupId)
```


#### 参数说明

| 参数名 | 输入/输出 | 说明 |
| --- | --- | --- |
| groupId | 输入 | 表示Group的ID，用于指定当前计算要使用的Group。 您需要提前调用aclrtGetGroupInfoDetail接口获取Group的ID。 |


#### 返回值说明

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


#### 约束说明

仅支持在 Atlas 推理系列产品 的Control CPU开放形态下调用本接口。不支持在 Atlas 推理系列产品 Ascend EP 形态下调用本接口。

acl接口调用顺序：调用aclrtSetDevice接口指定计算设备-->调用aclrtGetAllGroupInfo接口获取所有Group信息-->调用aclrtGetGroupCount接口获取Group数量-->调用aclrtGetGroupInfoDetail接口获取指定Group信息-->调用aclrtSetGroup接口设置分组-->执行其它任务-->调用aclrtResetDevice接口释放计算设备。

在调用acl接口设置算力Group前，需先调用驱动提供的DCMI接口dcmi_create_capability_group创建分组。若刷新分组（例如调用dcmi_create_capability_group接口新增分组、调用dcmi_delete_capability_group接口删除分组等），需重启业务进程。