gtpin::GtKernelExecStage Class Reference

Enumeration of the kernel execution stages (contexts) More...

#include <igt_kernel.h>

Public Types
enum	ENUM {   NONE,   DISPATCH,   FINAL_DISPATCH,   COMPLETE }
Public Member Functions
constexpr	GtKernelExecStage (ENUM v=NONE)
	Conversion constructor.
constexpr	operator ENUM () const
	Conversion operator.

---

Detailed Description

Enumeration of the kernel execution stages (contexts)

Normally, GTPin invokes two callbacks that indicate two kernel execution stages: OnKernelRun notifies about DISPATCH execution stage, and OnKernelComplete reports the final, COMPLETE stage of the kernel execution. However, on some plaforms, the kernel dispatch process can be logically divided on two stages. For example, in the L0 platform, the dispatch starts when the kernel is appended to the command list. At this point, GTPin invokes OnKernelRun callback in the DISPATCH context. The dispatch process finishes when runtime submits the command list for execution. At this point, GTPin may invoke second OnKernelRun callback in the FINAL_DISPATCH context, if requested by the IGtKernelDispatch::ReportFinalDispatchStage function. On platforms at which dispatch process is not divided on stages, single OnKernelRun callback is invoked in the DISPATCH context.

---

Member Enumeration Documentation

enum gtpin::GtKernelExecStage::ENUM

Enumerator:

NONE	Kernel is not yet dispatched for execution.
DISPATCH	Kernel has been dispatched for execution.
FINAL_DISPATCH	Final dispatch stage of the kernel(reported on selected platforms)
COMPLETE	Kernel finished execution.