openvino/docs/IE_PLUGIN_DG/AsyncInferRequest.md

Asynchronous Inference Request

@sphinxdirective

Asynchronous Inference Request runs an inference pipeline asynchronously in one or several task executors depending on a device pipeline structure. OpenVINO Runtime Plugin API provides the base ov::IAsyncInferRequest class:

• The class has the m_pipeline field of std::vector<std::pair<std::shared_ptr<ov::threading::ITaskExecutor>, ov::threading::Task> >, which contains pairs of an executor and executed task.
• All executors are passed as arguments to a class constructor and they are in the running state and ready to run tasks.
• The class has the ov::IAsyncInferRequest::stop_and_wait method, which waits for m_pipeline to finish in a class destructor. The method does not stop task executors and they are still in the running stage, because they belong to the compiled model instance and are not destroyed.

AsyncInferRequest Class #######################

OpenVINO Runtime Plugin API provides the base ov::IAsyncInferRequest class for a custom asynchronous inference request implementation:

.. doxygensnippet:: src/plugins/template/src/async_infer_request.hpp :language: cpp :fragment: [async_infer_request:header]

Class Fields ++++++++++++

• m_cancel_callback - a callback which allows to interrupt the execution
• m_wait_executor - a task executor that waits for a response from a device about device tasks completion

.. note::

If a plugin can work with several instances of a device, m_wait_executor must be device-specific. Otherwise, having a single task executor for several devices does not allow them to work in parallel.

AsyncInferRequest() +++++++++++++++++++

The main goal of the AsyncInferRequest constructor is to define a device pipeline m_pipeline. The example below demonstrates m_pipeline creation with the following stages:

• infer_preprocess_and_start_pipeline is a CPU ligthweight task to submit tasks to a remote device.
• wait_pipeline is a CPU non-compute task that waits for a response from a remote device.
• infer_postprocess is a CPU compute task.

.. doxygensnippet:: src/plugins/template/src/async_infer_request.cpp :language: cpp :fragment: [async_infer_request:ctor]

The stages are distributed among two task executors in the following way:

• infer_preprocess_and_start_pipeline prepare input tensors and run on m_request_executor, which computes CPU tasks.
• You need at least two executors to overlap compute tasks of a CPU and a remote device the plugin works with. Otherwise, CPU and device tasks are executed serially one by one.
• wait_pipeline is sent to m_wait_executor, which works with the device.

.. note::

m_callback_executor is also passed to the constructor and it is used in the base ov::IAsyncInferRequest class, which adds a pair of callback_executor and a callback function set by the user to the end of the pipeline.

~AsyncInferRequest() ++++++++++++++++++++

In the asynchronous request destructor, it is necessary to wait for a pipeline to finish. It can be done using the ov::IAsyncInferRequest::stop_and_wait method of the base class.

.. doxygensnippet:: src/plugins/template/src/async_infer_request.cpp :language: cpp :fragment: [async_infer_request:dtor]

cancel() ++++++++

The method allows to cancel the infer request execution:

.. doxygensnippet:: src/plugins/template/src/async_infer_request.cpp :language: cpp :fragment: [async_infer_request:cancel]

@endsphinxdirective