---
title: aclmdlRICaptureTaskUpdateBegin
description: "须知：本接口为试验特性，后续版本可能会存在变更，不支持应用于商用产品中。"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/runtimeapi/aclcppdevg_03_1825.html
sourcePath: /source/zh/canncommercial/900/API/runtimeapi/aclcppdevg_03_1825.html
indexId: 4ff452e203374aee597d8c8d095304510b6156bc51b8e1ff8912ba10556acd3368
---
# aclmdlRICaptureTaskUpdateBegin

须知：本接口为试验特性，后续版本可能会存在变更，不支持应用于商用产品中。

#### 产品支持情况

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


#### 功能说明

标记待更新任务的开始。

本接口与aclmdlRICaptureTaskUpdateEnd接口成对使用，位于这两个接口之间的任务需更新。

aclmdlRICaptureTaskUpdateBegin、aclmdlRICaptureTaskUpdateEnd接口之间的任务数量、任务类型必须与aclmdlRICaptureTaskGrpBegin、aclmdlRICaptureTaskGrpEnd接口之间任务数量、任务类型保持一致。

若任务更新时返回ACL_ERROR_RT_FEATURE_NOT_SUPPORT，这表示底层驱动不支持该特性，需升级驱动包。您可以单击Link(https://www.hiascend.com/hardware/firmware-drivers/commercial)，在“固件与驱动”页面下载对应版本的驱动安装包，并参照其文档进行安装和升级。- 针对Atlas A2 训练系列产品 / Atlas A2 推理系列产品、Atlas A3 训练系列产品 / Atlas A3 推理系列产品，需将驱动包升级到25.0.RC1或更高版本。
- 针对Atlas 推理系列产品，需将驱动包升级到26.0.RC1或更高版本。


#### 函数原型

```
aclError aclmdlRICaptureTaskUpdateBegin(aclrtStream stream, aclrtTaskGrp handle)
```


#### 参数说明

| 参数名 | 输入/输出 | 说明 |
| --- | --- | --- |
| stream | 输入 | 指定Stream。类型定义请参见aclrtStream。 此处的Stream必须是不在捕获状态的Stream。 |
| handle | 输入 | 标识任务组的句柄。类型定义请参见aclrtTaskGrp。 提前调用aclmdlRICaptureTaskGrpBegin、aclmdlRICaptureTaskGrpEnd接口标记任务组，并通过aclmdlRICaptureTaskGrpEnd接口获取任务组句柄，再作为入参传入此处。 |


#### 返回值说明

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


#### 约束说明

对于 Atlas A2 训练系列产品 / Atlas A2 推理系列产品 、 Atlas A3 训练系列产品 / Atlas A3 推理系列产品 ，如果CANN配套的Ascend HDK的版本为25.5.X之前（不包含该版本），那么单个Device可支持同时更新的最大任务数是1024*1024个，超出该规格，任务会在执行阶段报错。


#### 接口调用示例

接口调用示例，参见任务更新(https://www.hiascend.comdocument/detail/zh/canncommercial/900/programug/acldevg/runtime_doc_dev_0032.html)。