aclmdlRICaptureTaskUpdateBegin

Note: This API is for trial use and may be changed in later versions. It is not available in commercial products.

Applicability

Product	Supported
Atlas 350 Accelerator Card	√
Atlas A3 training product / Atlas A3 inference product	√
Atlas A2 training product / Atlas A2 inference product	√
Atlas 200I/500 A2 inference product	☓
Atlas inference product	√
Atlas training product	☓

Description

Marks the start of the tasks to be updated.

This API and aclmdlRICaptureTaskUpdateEnd are used in pairs. The tasks between these 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 Runtime Instance Management