---
title: aclrtSwitchLabelByIndex
description: "| 产品 | 是否支持 |"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/runtimeapi/aclcppdevg_03_1890.html
sourcePath: /source/zh/canncommercial/900/API/runtimeapi/aclcppdevg_03_1890.html
indexId: 01a26fef772d42aa48524981310b7a96bd05d56cd850702e5590eb1ee82a197568
---
# aclrtSwitchLabelByIndex

#### 产品支持情况

| 产品 | 是否支持 |
| --- | --- |
| Atlas 350 加速卡 | √ |
| Atlas A3 训练系列产品 / Atlas A3 推理系列产品 | √ |
| Atlas A2 训练系列产品 / Atlas A2 推理系列产品 | √ |
| Atlas 200I/500 A2 推理产品 | √ |
| Atlas 推理系列产品 | √ |
| Atlas 训练系列产品 | √ |


#### 功能说明

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


#### 函数原型

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


#### 参数说明

| 参数名 | 输入/输出 | 说明 |
| --- | --- | --- |
| ptr | 输入 | 标签索引。 存放目标标签索引值的Device内存地址，索引值的数据类型uint32，长度4字节，索引值从0开始。 当目标标签索引大于labelList数组的最大索引值时，跳转到最大标签。 |
| maxValue | 输入 | 标签列表中的标签个数。 |
| labelList | 输入 | 标签列表。类型定义请参见aclrtLabelList。 通过aclrtCreateLabelList接口创建的标签列表作为此处的输入。 |
| stream | 输入 | 执行跳转任务的Stream。类型定义请参见aclrtStream。 |


#### 返回值说明

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