aclrtGetGroupInfoDetail

产品支持情况

产品	是否支持
Atlas A3 训练系列产品/Atlas A3 推理系列产品	x
Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件	x
Atlas 200I/500 A2 推理产品	x
Atlas 推理系列产品	x
Atlas 训练系列产品	x
Atlas 200/300/500 推理产品	x

Atlas 推理系列产品，Ascend EP形态下，不支持调用本接口。

功能说明

查询当前Context下指定Group的算力信息。

函数原型

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

参数说明

参数名	输入/输出	说明
groupInfo	输入	指定算力详细信息的首地址的指针。需提前调用aclrtGetAllGroupInfo接口获取所有Group的算力信息。
groupIndex	输入	访问groupInfo连续内存块的Group索引。 Group索引的取值范围：[0, (Group数量-1)]，用户可调用aclrtGetGroupCount接口获取Group数量。
attr	输入	指定要获取其算力值的算力属性。
attrValue	输出	获取指定算力属性所对应的算力值的指针。用户需根据每个属性的属性值数据类型申请对应大小的内存，用于存放属性值。
valueLen	输入	表示attrValue的最大长度，单位为Byte。
paramRetSize	输出	实际返回的attrValue大小的指针，单位为Byte。

返回值说明

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

约束说明

调用DCMI提供的dcmi_create_capability_group接口创建分组后，再调用acl接口进行算力Group查询与设置。

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

若刷新分组（例如调用dcmi_create_capability_group接口新增分组、调用dcmi_delete_capability_group接口删除分组等），需重启业务进程。

父主题： 算力Group查询与设置