下载
中文
注册

aclrtGetGroupInfoDetail

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

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

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

Atlas A2 训练系列产品/Atlas 800I A2 推理产品 ,不支持该接口。

函数功能

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

约束说明

  • Atlas 推理系列产品 ,Ascend EP标准形态下,不支持调用本接口。
  • 调用DCMI提供的dcmi_create_capability_group接口创建分组后,再调用AscendCL接口进行算力Group查询与设置。

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

    若刷新分组(例如调用dcmi_create_capability_group接口新增分组、调用dcmi_delete_capability_group接口删除分组等),需重启业务AscendCL应用进程。

函数原型

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