aclrtUnSubscribeReport

Description

In asynchronous task scenarios, call this API to deregister from a thread. The callback function in the stream will be no longer processed by the thread.

This API must be work with the following APIs to implement the callback function in asynchronous scenarios:
  1. Define and implement a callback function. Function prototype: typedef void (*aclrtCallback)(void *userData)
  2. Create a thread. Call aclrtProcessReport in the thread function to set the timeout interval (cyclic calling is required), and wait for the callback task execution.
  3. Call aclrtSubscribeReport to bind the thread created in Step 2 to the stream. The callback function delivered by the stream is executed in the bound thread.
  4. Execute an asynchronous task (for example, an asynchronous inference job) on the specified stream.
  5. Call aclrtLaunchCallback to deliver a callback task in the task queue of the stream and trigger the thread created in step 2 to process the callback function. Each time aclrtLaunchCallback is called, the callback function is executed.
  6. After all asynchronous tasks are executed, call aclrtUnSubscribeReport to unsubscribe from the thread.

Prototype

aclError aclrtUnSubscribeReport(uint64_t threadId, aclrtStream stream)

Parameters

Parameter

Input/Output

Description

threadId

Input

Thread ID.

stream

Input

Stream.

Returns

The value 0 indicates success, and other values indicate failure. For details, see aclError.

Reference

For details about the API call sequence and sample code, see Asynchronous Model Inference.