aclrtSetGroup

Applicable Products

Product	Supported
Ascend 950PR/Ascend 950DT	☓
Atlas A3 training products/Atlas A3 inference products	☓
Atlas A2 training products/Atlas A2 inference products	☓
Atlas 200I/500 A2 inference products	☓
Atlas inference products	√
Atlas training products	☓

Function

Sets the compute group. This API must be called after the context is specified.

Prototype

aclError aclrtSetGroup(int32_t groupId)

Parameters

Parameter	Input/Output	Description
groupId	Input	Compute group ID. Call aclrtGetGroupInfoDetail to obtain the group ID in advance.

Parameter

Input/Output

Description

groupId

Input

Compute group ID.

Call aclrtGetGroupInfoDetail to obtain the group ID in advance.

Returns

0 on success; otherwise, failure. For details, see aclError.

Restrictions

This API can be called only in the Ctrl CPU open form of the Atlas inference product. This API cannot be called in the Ascend EP form of the Atlas inference product.

acl API call sequence: aclrtSetDevice (specifies a compute device) --> aclrtGetAllGroupInfo (obtains the information of all groups) --> aclrtGetGroupCount (obtains the group count) --> aclrtGetGroupInfoDetail (obtains the information of a specified group) --> aclrtSetGroup (sets a group) --> execution of other tasks --> aclrtResetDevice (resets the compute device).

Before calling the acl API to set the computing power group, call the DCMI API dcmi_create_capability_group provided by the driver to create a group. If the group is updated (for example, the dcmi_create_capability_group API is called to add a group or the dcmi_delete_capability_group API is called to delete a group), the service process needs to be restarted.

Parent topic: Group Management