Driver - Experimental#
oneAPI Level Zero Specification - Version 1.18.31
Driver - Experimental Functions#
zesDriverGetDeviceByUuidExp#
Added in version 1.9
-
ZE_APIEXPORT ze_result_t ZE_APICALL zesDriverGetDeviceByUuidExp(zes_driver_handle_t hDriver, zes_uuid_t uuid, zes_device_handle_t *phDevice, ze_bool_t *onSubdevice, uint32_t *subdeviceId)#
Retrieves sysman device and subdevice index for the given UUID and sysman driver.
The application may call this function from simultaneous threads.
The implementation of this function should be lock-free.
- Parameters:
hDriver – [in] handle of the sysman driver instance
uuid – [in] universal unique identifier.
phDevice – [out] Sysman handle of the device.
onSubdevice – [out] True if the UUID belongs to the sub-device; false means that UUID belongs to the root device.
subdeviceId – [out] If onSubdevice is true, this gives the ID of the sub-device
- Returns:
ZE_RESULT_ERROR_INVALID_NULL_HANDLE
nullptr == hDriver
ZE_RESULT_ERROR_INVALID_NULL_POINTER
nullptr == phDevicenullptr == onSubdevicenullptr == subdeviceId