aclrtGetOverflowStatus

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

Obtains the overflow status of tasks on all streams in the current device and copies the status value to the device memory allocated by the user. This API is asynchronous.

Prototype

aclError aclrtGetOverflowStatus(void *outputAddr, size_t outputSize, aclrtStream stream)

Parameters

Parameter

Input/Output

Description

outputAddr

Input/Output

Device memory allocated by the user, which needs to be allocated by calling aclrtMalloc.

To view data on the host, call aclrtMemcpy or aclrtMemcpyAsync to transfer data from the device to the host.

outputSize

Input

Size of the device memory to be allocated, in bytes. The fixed size is 64 bytes.

stream

Input

Specified stream to deliver an overflow status query task.

Returns

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

Restrictions

For the following product models, the overflow status queried by this API is at the process level.

  • Atlas A3 training products/Atlas A3 inference products
  • Atlas A2 training products/Atlas A2 inference products