aclrtGetGroupInfoDetail
函数功能
查询当前Context下指定Group的算力信息。
Atlas 200/300/500 推理产品，不支持该接口。
Atlas 200I/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表示成功，返回其它值表示失败。
