Scheduler - Deprecated

oneAPI Level Zero Specification - Version 1.20.41

Scheduler - Deprecated Functions

zesSchedulerSetComputeUnitDebugMode

Added in version 1.0

Deprecated since 1.8. Enable debugging with ZET_ENABLE_PROGRAM_DEBUGGING, and select devices with ZE_AFFINITY_MASK. Related: zetDebugAttach.

ZE_APIEXPORT ze_result_t ZE_APICALL zesSchedulerSetComputeUnitDebugMode(zes_sched_handle_t hScheduler, ze_bool_t *pNeedReload)

Change scheduler mode to ZES_SCHED_MODE_COMPUTE_UNIT_DEBUG

• This is a special mode that must ben enabled when debugging an application that uses this device e.g. using the Level0 Debug API.

• It ensures that only one command queue can execute work on the hardware at a given time. Work is permitted to run as long as needed without enforcing any scheduler fairness policies.

• The application may call this function from simultaneous threads.

• The implementation of this function should be lock-free.

Parameters:

• hScheduler – [in] Sysman handle for the component.

• pNeedReload – [in,out] Will be set to TRUE if a device driver reload is needed to apply the new scheduler mode.

Returns:

• ZE_RESULT_SUCCESS

• ZE_RESULT_ERROR_UNINITIALIZED

• ZE_RESULT_ERROR_DEVICE_LOST

• ZE_RESULT_ERROR_OUT_OF_HOST_MEMORY

• ZE_RESULT_ERROR_OUT_OF_DEVICE_MEMORY

• ZE_RESULT_ERROR_INVALID_ARGUMENT

• ZE_RESULT_ERROR_DEPENDENCY_UNAVAILABLE

• ZE_RESULT_ERROR_NOT_AVAILABLE

• ZE_RESULT_ERROR_DEVICE_REQUIRES_RESET

• ZE_RESULT_ERROR_DEVICE_IN_LOW_POWER_STATE

• ZE_RESULT_ERROR_UNKNOWN

• ZE_RESULT_ERROR_INVALID_NULL_HANDLE

  • nullptr == hScheduler

• ZE_RESULT_ERROR_INVALID_NULL_POINTER

  • nullptr == pNeedReload

• ZE_RESULT_ERROR_UNSUPPORTED_FEATURE

  • This scheduler component does not support scheduler modes.

• ZE_RESULT_ERROR_INSUFFICIENT_PERMISSIONS

  • User does not have permissions to make this modification.