Global - Deprecated

oneAPI Level Zero Specification - Version 1.20.41

Global - Deprecated Functions

zeInit

Added in version 1.0

Deprecated since 1.10. Use zeInitDrivers instead.

ZE_APIEXPORT ze_result_t ZE_APICALL zeInit(ze_init_flags_t flags)

Initialize the ‘oneAPI’ driver(s)

• The application must call this function or zeInitDrivers before calling any other function.

• If this function is not called then all other functions will return ZE_RESULT_ERROR_UNINITIALIZED.

• Only one instance of each driver will be initialized per process.

• The application may call this function multiple times with different flags or environment variables enabled.

• The application must call this function after forking new processes. Each forked process must call this function.

• The application may call this function from simultaneous threads.

• The implementation of this function must be thread-safe for scenarios where multiple libraries may initialize the driver(s) simultaneously.

Parameters:

flags – [in] initialization flags. must be 0 (default) or a combination of ze_init_flag_t.

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_ENUMERATION

  • 0x3 < flags

• ZE_RESULT_ERROR_UNSUPPORTED_ENUMERATION