Driver - Experimental

oneAPI Level Zero Specification - Version 1.18.31

Driver - Experimental Functions

zeDriverRTASFormatCompatibilityCheckExp

Added in version 1.7

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.