aclrtGetGroupInfoDetail

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

Obtains the compute capability details of a group in the current context.

Prototype

aclError  aclrtGetGroupInfoDetail(const aclrtGroupInfo *groupInfo, int32_t groupIndex, aclrtGroupAttr attr, void *attrValue, size_t valueLen, size_t *paramRetSize)

Parameters

Parameter	Input/Output	Description
groupInfo	Input	Pointer to the start address of the compute capability details. Call aclrtGetAllGroupInfo to obtain the compute capability details of all groups.
groupIndex	Input	Group index for accessing contiguous memory blocks with groupInfo. Must be within the range of [0, Group count – 1]. Call aclrtGetGroupCount to obtain the group count.
attr	Input	Compute capability attribute to be obtained.
attrValue	Output	Pointer to the value of the compute capability attribute to be obtained. Allocate memory according to the data type of each attribute value to store the attribute values.
valueLen	Input	Maximum length of attrValue, in bytes.
paramRetSize	Output	Pointer to the size of the returned attrValue, in bytes.

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.

Parent topic: Group Management