aclrtGetOverflowStatus
The
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.
Restrictions
- This API is asynchronous. The API call delivers a task rather than executes a task. After this API is called, you need to call a synchronization API (for example, aclrtSynchronizeStream) to ensure that the task is complete. Otherwise, service exceptions (such as training or inference exception) or unknown situations (such as device link or card disconnection) may occur.
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 |
Specifies a stream to deliver an overflow status query task. |
Returns
The value 0 indicates success, and other values indicate failure. For details, see aclError.