aclmdlRICaptureTaskUpdateBegin

Applicable Products

Product	Supported
Ascend 950PR / Ascend 950DT	√
Atlas A3 training products / Atlas A3 inference products	√
Atlas A2 training products / Atlas A2 inference products	√
Atlas 200I/500 A2 inference products	☓
Atlas inference products	√
Atlas training products	☓

Function

Marks the start of the tasks to be updated.

This API and aclmdlRICaptureTaskUpdateEnd are used as a pair. The tasks between the two APIs need to be updated.

The number and type of tasks between aclmdlRICaptureTaskUpdateBegin and aclmdlRICaptureTaskUpdateEnd must be the same as those of tasks between aclmdlRICaptureTaskGrpBegin and aclmdlRICaptureTaskGrpEnd.

If ACL_ERROR_RT_FEATURE_NOT_SUPPORT is returned during task update, the underlying driver does not support this feature. In this case, upgrade the driver package. You can click Link to download the driver installation package of the required version on the Firmware & Drivers page and install and upgrade the driver by referring to the corresponding document.

For the Atlas A2 training product / Atlas A2 inference product and Atlas A3 training product / Atlas A3 inference product , upgrade the driver package to 25.0.RC1 or later.
For the Atlas inference product , upgrade the driver package to 26.0.RC1 or later.

Prototype

      
           aclError aclmdlRICaptureTaskUpdateBegin(aclrtStream stream, aclrtTaskGrp handle)

Parameters

Parameter	Input/Output	Description
stream	Input	Stream. For details about the type definition, see aclrtStream. The stream must not be in the capture state.
handle	Input	Handle to a task group. For details about the type definition, see aclrtTaskGrp. Call aclmdlRICaptureTaskGrpBegin and aclmdlRICaptureTaskGrpEnd to mark the task group, call aclmdlRICaptureTaskGrpEnd to obtain the task group handle, and pass the handle as an input parameter.

Parameter

Input/Output

Description

stream

Input

Stream. For details about the type definition, see aclrtStream.

The stream must not be in the capture state.

handle

Input

Handle to a task group. For details about the type definition, see aclrtTaskGrp.

Call aclmdlRICaptureTaskGrpBegin and aclmdlRICaptureTaskGrpEnd to mark the task group, call aclmdlRICaptureTaskGrpEnd to obtain the task group handle, and pass the handle as an input parameter.

Returns

0 on success; otherwise, failure. For details, see aclError.

Restrictions

For the Atlas A2 training product / Atlas A2 inference product and Atlas A3 training product / Atlas A3 inference product , if the Ascend HDK version matching CANN is earlier than 25.5.X, a single device supports a maximum of 1,024 x 1,024 concurrent update tasks. If this limit is exceeded, an error is reported during task execution.

API Call Example

For the API call example, see Task Update.

Parent topic: Model Running Instance Management