aclrtGetGroupCount
aclrtGetOverflowStatus
函数功能
获取当前Context下所有Stream上任务的溢出状态，并将状态值拷贝到用户申请的Device内存中。异步接口。
约束说明
本接口是异步接口，在调用之后，需调用aclrtSynchronizeStream接口阻塞应用程序运行，直到指定Stream中的溢出状态查询任务已完成。
函数原型
aclError aclrtGetOverflowStatus(void *outputAddr, size_t outputSize, aclrtStream stream)
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| outputAddr | 输入&输出 | 用户申请的Device内存，需通过aclrtMalloc接口申请。 |
| outputSize | 输入 | 需申请的Device内存大小，单位Byte，固定大小为64Byte。 |
| stream | 输入 | 指定Stream，用于下发溢出状态查询任务。 |
返回值说明
返回0表示成功，返回其它值表示失败。
父主题： Context管理
aclrtResetOverflowStatus
函数功能
清除当前Context下所有Stream上任务的溢出状态。异步接口。
约束说明
本接口是异步接口，在调用之后，需调用aclrtSynchronizeStream接口阻塞应用程序运行，直到指定Stream中的溢出状态复位任务已完成。
函数原型
aclError aclrtResetOverflowStatus(aclrtStream stream)
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| stream | 输入 | 指定Stream，用于下发溢出状态复位任务。 |
返回值说明
返回0表示成功，返回其它值表示失败。
父主题： Context管理
aclrtSetGroup
函数功能
指定当前运算使用哪个Group的算力，该接口必须在指定Context后调用。
Atlas 200/500 A2推理产品，不支持该接口。
函数原型
aclError aclrtSetGroup(int32_t groupId)
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| groupId | 输入 | 表示Group的ID，用于指定当前计算要使用的Group。 您需要提前调用aclrtGetGroupInfoDetail接口获取Group的ID。 |
返回值说明
返回0表示成功，返回其它值表示失败。
父主题： 算力Group查询与设置
aclrtGetGroupCount
函数功能
查询当前Context下可以使用的Group个数。
Atlas 200/500 A2推理产品，不支持该接口。
函数原型
aclError aclrtGetGroupCount(uint32_t *count)
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| count | 输出 | 当前Context下可用Group个数的指针。 |
返回值说明
返回0表示成功，返回其它值表示失败。
父主题： 算力Group查询与设置
aclrtGetAllGroupInfo
函数功能
查询当前Context下可以使用的所有Group的详细算力信息。
Atlas 200/500 A2推理产品，不支持该接口。
函数原型
aclError aclrtGetAllGroupInfo(aclrtGroupInfo *groupInfo)
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| groupInfo | 输出 | 获取所有Group对应的详细算力信息的指针。 需提前调用aclrtCreateGroupInfo接口创建aclrtGroupInfo类型的数据。 |
返回值说明
返回0表示成功，返回其它值表示失败。
父主题： 算力Group查询与设置
aclrtGetGroupInfoDetail
函数功能
查询当前Context下指定Group的算力信息。
Atlas 200/500 A2推理产品，不支持该接口。
函数原型
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查询与设置
aclrtCreateGroupInfo
函数功能
根据实际支持的Group数量创建aclrtGroupInfo类型的连续内存块，并返回对应指针。
如需销毁aclrtGroupInfo类型的数据，请参见aclrtDestroyGroupInfo。
Atlas 200/500 A2推理产品，不支持该接口。
函数原型
aclrtGroupInfo *aclrtCreateGroupInfo()
参数说明
无
返回值说明
返回aclrtGroupInfo类型的指针，如果无Group或不支持Group则返回nullptr。
父主题： 算力Group查询与设置
在线提单