Driver - Deprecated

oneAPI Level Zero Specification - Version 1.20.41

Driver - Deprecated Functions

zeDriverGet

Added in version 1.0

Deprecated since 1.10. Use zeInitDrivers instead.

ZE_APIEXPORT ze_result_t ZE_APICALL zeDriverGet(uint32_t *pCount, ze_driver_handle_t *phDrivers)

Retrieves driver instances

• Usage of zeInitDrivers and zeDriverGet is mutually exclusive and should not be used together. Usage of them together will result in undefined behavior.

• A driver represents a collection of physical devices.

• Multiple calls to this function will return identical driver handles, in the same order.

• The application may pass nullptr for pDrivers when only querying the number of drivers.

• The application may call this function from simultaneous threads.

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

Remark

Analogues

• clGetPlatformIDs

Parameters:

• pCount – [in,out] pointer to the number of driver instances. if count is zero, then the loader shall update the value with the total number of drivers available. if count is greater than the number of drivers available, then the loader shall update the value with the correct number of drivers available.

• phDrivers – [in,out][optional][range(0, *pCount)] array of driver instance handles. if count is less than the number of drivers available, then the loader shall only retrieve that number of drivers.

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_UNSUPPORTED_FEATURE

• ZE_RESULT_ERROR_DEPENDENCY_UNAVAILABLE

• ZE_RESULT_ERROR_INSUFFICIENT_PERMISSIONS

• 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_POINTER

  • nullptr == pCount

zeDriverRTASFormatCompatibilityCheckExp

Added in version 1.7

Deprecated since 1.13. Use zeDriverRTASFormatCompatibilityCheckExt instead.

ZE_APIEXPORT ze_result_t ZE_APICALL zeDriverRTASFormatCompatibilityCheckExp(ze_driver_handle_t hDriver, ze_rtas_format_exp_t rtasFormatA, ze_rtas_format_exp_t rtasFormatB)

Checks ray tracing acceleration structure format compatibility

• The application may call this function from simultaneous threads.

• The implementation of this function must be thread-safe.

Parameters:

• hDriver – [in] handle of driver object

• rtasFormatA – [in] operand A

• rtasFormatB – [in] operand B

Returns:

• 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_UNSUPPORTED_FEATURE

• ZE_RESULT_ERROR_DEPENDENCY_UNAVAILABLE

• ZE_RESULT_ERROR_INSUFFICIENT_PERMISSIONS

• 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 == hDriver

• ZE_RESULT_ERROR_INVALID_ENUMERATION

  • ZE_RTAS_FORMAT_EXP_MAX < rtasFormatA

  • ZE_RTAS_FORMAT_EXP_MAX < rtasFormatB

• ZE_RESULT_ERROR_UNSUPPORTED_ENUMERATION

• ZE_RESULT_SUCCESS

  • An acceleration structure built with rtasFormatA is compatible with devices that report rtasFormatB.

• ZE_RESULT_EXP_ERROR_OPERANDS_INCOMPATIBLE

  • An acceleration structure built with rtasFormatA is not compatible with devices that report rtasFormatB.