aclrtSetGroup

Applicability

Product

Supported

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

Description

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.

Returns

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

Restrictions

This API cannot be called in the Ascend EP of Atlas inference products.

Before calling an acl API to query or set a compute group, you need to call the dcmi_create_capability_group DCMI API to create a group.

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).

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.