昇腾社区首页
中文
注册

aclrtSwitchLabelByIndex

产品支持情况

产品

是否支持

Atlas A3 训练系列产品/Atlas A3 推理系列产品

x

Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件

Atlas 200I/500 A2 推理产品

Atlas 推理系列产品

Atlas 训练系列产品

Atlas 200/300/500 推理产品

x

功能说明

根据标签索引跳转到相应的标签位置,执行该标签所在Stream上的任务,同时当前Stream上的任务停止执行。

函数原型

aclError aclrtSwitchLabelByIndex(void *ptr, uint32_t maxValue, aclrtLabelList labelList, aclrtStream stream)

参数说明

参数名

输入/输出

说明

ptr

输入

标签索引。

存放目标标签索引值的Device内存地址,索引值的数据类型uint32,长度4字节,索引值从0开始。

当目标标签索引大于labelList数组的最大索引值时,跳转到最大标签。

maxValue

输入

标签列表中的标签个数。

labelList

输入

标签列表。

通过aclrtCreateLabelList接口创建的标签列表作为此处的输入。

stream

输入

执行跳转任务的Stream。

返回值说明

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