aclrtGetGroupInfoDetail

函数功能

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

Atlas 200/300/500 推理产品，不支持该接口。

Atlas 200/500 A2推理产品，不支持该接口。

Atlas 训练系列产品，不支持该接口。

Atlas A2训练系列产品，不支持该接口。

约束说明

Atlas 推理系列产品（Ascend 310P处理器），Ascend EP标准形态下，不支持调用本接口。
调用DSMI提供的dsmi_create_capability_group接口创建分组后，再调用AscendCL接口进行算力Group查询与设置。
AscendCL接口调用顺序：调用aclrtSetDevice接口指定计算设备-->调用aclrtGetAllGroupInfo接口获取所有Group信息-->调用aclrtGetGroupCount接口获取Group数量-->调用aclrtGetGroupInfoDetail接口获取指定Group信息-->调用aclrtSetGroup接口设置分组-->执行其它任务-->调用aclrtResetDevice接口释放计算设备。

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

dsmi_create_capability_group接口和dsmi_delete_capability_group接口的详细说明请参见《DSMI API参考》。

函数原型

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表示成功，返回其它值表示失败。

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