Tracer Exp

Tracer Exp#

oneAPI Level Zero Specification - Version 1.18.31

Tracer Exp Functions#

zetTracerExpCreate#

Added in version 1.0

ZE_APIEXPORT ze_result_t ZE_APICALL zetTracerExpCreate(zet_context_handle_t hContext, const zet_tracer_exp_desc_t *desc, zet_tracer_exp_handle_t *phTracer)#

Creates a tracer on the context.

  • Deprecated:

    This function is not supported in L0 drivers and has been replaced by the Loader Tracing Layer. See the Loader Tracing documentation for more details.

Parameters:

  • hContext – [in] handle of the context object

  • desc – [in] pointer to tracer descriptor

  • phTracer – [out] pointer to handle of tracer object created

Returns:

zetTracerExpDestroy#

Added in version 1.0

ZE_APIEXPORT ze_result_t ZE_APICALL zetTracerExpDestroy(zet_tracer_exp_handle_t hTracer)#

Destroys a tracer.

  • Deprecated:

    This function is not supported in L0 drivers and has been replaced by the Loader Tracing Layer. See the Loader Tracing documentation for more details.

Parameters:

hTracer – [in][release] handle of tracer object to destroy

Returns:

zetTracerExpSetPrologues#

Added in version 1.0

ZE_APIEXPORT ze_result_t ZE_APICALL zetTracerExpSetPrologues(zet_tracer_exp_handle_t hTracer, zet_core_callbacks_t *pCoreCbs)#

Sets the collection of callbacks to be executed before driver execution.

  • Deprecated:

    This function is not supported in L0 drivers and has been replaced by the Loader Tracing Layer. See the Loader Tracing documentation for more details.

Parameters:

  • hTracer – [in] handle of the tracer

  • pCoreCbs – [in] pointer to table of ‘core’ callback function pointers

Returns:

zetTracerExpSetEpilogues#

Added in version 1.0

ZE_APIEXPORT ze_result_t ZE_APICALL zetTracerExpSetEpilogues(zet_tracer_exp_handle_t hTracer, zet_core_callbacks_t *pCoreCbs)#

Sets the collection of callbacks to be executed after driver execution.

  • Deprecated:

    This function is not supported in L0 drivers and has been replaced by the Loader Tracing Layer. See the Loader Tracing documentation for more details.

Parameters:

  • hTracer – [in] handle of the tracer

  • pCoreCbs – [in] pointer to table of ‘core’ callback function pointers

Returns:

zetTracerExpSetEnabled#

Added in version 1.0

ZE_APIEXPORT ze_result_t ZE_APICALL zetTracerExpSetEnabled(zet_tracer_exp_handle_t hTracer, ze_bool_t enable)#

Enables (or disables) the tracer.

  • Deprecated:

    This function is not supported in L0 drivers and has been replaced by the Loader Tracing Layer. See the Loader Tracing documentation for more details.

Parameters:

  • hTracer – [in] handle of the tracer

  • enable – [in] enable the tracer if true; disable if false

Returns: