aclmdlRICaptureTaskUpdateBegin

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

Applicability

Product

Supported

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

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, the underlying driver does not support this feature. In this case, you need to upgrade the driver package to 25.0.RC1 or later. You can click here to download the driver installation package of Ascend HDK 25.0.RC1 or later on the Firmware and Drivers page and install or upgrade the driver by referring to the document of the corresponding version.

Prototype

aclError aclmdlRICaptureTaskUpdateBegin(aclrtStream stream, aclrtTaskGrp handle)

Parameters

Parameter

Input/Output

Description

stream

Input

Stream.

The stream must not be in the capture state.

handle

Input

Handle to a task group.

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; else, failure. For details, see aclError.

Restrictions

For Atlas A2 training products/Atlas A2 inference products and Atlas A3 training products/Atlas A3 inference products, if the version of the Ascend HDK matching CANN is earlier than 25.5.X (excluding this version), a single device supports a maximum of 1024 x 1024 tasks that can be updated at the same time. If the number of tasks exceeds this specification, an error is reported during task execution.