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

#### 产品支持情况

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


#### 功能说明

当一个Stream上下发了多个任务时，可通过本接口指定任务调度模式，以便控制某个任务失败后是否继续执行下一个任务。


#### 函数原型

```
aclError aclrtSetStreamFailureMode(aclrtStream stream, uint64_t mode)
```


#### 参数说明

| 参数名 | 输入/输出 | 说明 |
| --- | --- | --- |
| stream | 输入 | 待操作Stream。类型定义请参见aclrtStream。 各产品型号对默认Stream（即该参数传入NULL）的支持情况不同，如下： Atlas 350 加速卡，不支持 Atlas A3 训练系列产品 / Atlas A3 推理系列产品 ，支持 Atlas A2 训练系列产品 / Atlas A2 推理系列产品 ，支持 Atlas 200I/500 A2 推理产品 ，不支持 Atlas 推理系列产品 ，不支持 Atlas 训练系列产品 ，不支持 |
| mode | 输入 | 当一个Stream上下发了多个任务时，可通过本参数指定任务调度模式，以便控制某个任务失败后是否继续执行下一个任务。 取值范围如下： ACL\_CONTINUE\_ON\_FAILURE：默认值，某个任务失败后，继续执行下一个任务； ACL\_STOP\_ON\_FAILURE：某个任务失败后，停止执行后续任务，通常称作遇错即停。触发遇错即停之后，不支持再下发新任务。 |


#### 返回值说明

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


#### 约束说明

- 针对指定Stream只能调用一次本接口设置任务调度模式。
- 当Stream上设置了遇错即停模式，该Stream所在的Context下的其它Stream也是遇错即停 。该约束适用于以下产品型号：
  Atlas A3 训练系列产品 / Atlas A3 推理系列产品

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

  Atlas 200I/500 A2 推理产品

  Atlas 推理系列产品

  Atlas 训练系列产品


#### 接口调用示例

接口调用示例，参见配置任务遇错即停(https://www.hiascend.comdocument/detail/zh/canncommercial/900/programug/acldevg/runtime_doc_dev_0017.html)。