@@ -492,6 +492,8 @@ typedef enum ur_result_t {
492492 UR_RESULT_ERROR_ADAPTER_SPECIFIC = 67, ///< An adapter specific warning/error has been reported and can be
493493 ///< retrieved via the urPlatformGetLastError entry point.
494494 UR_RESULT_ERROR_LAYER_NOT_PRESENT = 68, ///< A requested layer was not found by the loader.
495+ UR_RESULT_ERROR_IN_EVENT_LIST_EXEC_STATUS = 69, ///< An event in the provided wait list has ::UR_EVENT_STATUS_ERROR.
496+ UR_RESULT_ERROR_DEVICE_NOT_AVAILABLE = 70, ///< Device in question has `::UR_DEVICE_INFO_AVAILABLE == false`
495497 UR_RESULT_ERROR_INVALID_COMMAND_BUFFER_EXP = 0x1000, ///< Invalid Command-Buffer
496498 UR_RESULT_ERROR_INVALID_COMMAND_BUFFER_SYNC_POINT_EXP = 0x1001, ///< Sync point is not valid for the command-buffer
497499 UR_RESULT_ERROR_INVALID_COMMAND_BUFFER_SYNC_POINT_WAIT_LIST_EXP = 0x1002, ///< Sync point wait list is invalid
@@ -2645,6 +2647,7 @@ typedef struct ur_buffer_alloc_location_properties_t {
26452647/// - ::UR_RESULT_ERROR_INVALID_CONTEXT
26462648/// - ::UR_RESULT_ERROR_INVALID_VALUE
26472649/// - ::UR_RESULT_ERROR_INVALID_BUFFER_SIZE
2650+ /// + `size == 0`
26482651/// - ::UR_RESULT_ERROR_INVALID_HOST_PTR
26492652/// + `pProperties == NULL && (flags & (UR_MEM_FLAG_USE_HOST_POINTER | UR_MEM_FLAG_ALLOC_COPY_HOST_POINTER)) != 0`
26502653/// + `pProperties != NULL && pProperties->pHost == NULL && (flags & (UR_MEM_FLAG_USE_HOST_POINTER | UR_MEM_FLAG_ALLOC_COPY_HOST_POINTER)) != 0`
@@ -2753,6 +2756,8 @@ typedef enum ur_buffer_create_type_t {
27532756/// - ::UR_RESULT_ERROR_OBJECT_ALLOCATION_FAILURE
27542757/// - ::UR_RESULT_ERROR_INVALID_VALUE
27552758/// - ::UR_RESULT_ERROR_INVALID_BUFFER_SIZE
2759+ /// + `pRegion && pRegion->size == 0`
2760+ /// + hBuffer allocation size < (pRegion->origin + pRegion->size)
27562761/// - ::UR_RESULT_ERROR_INVALID_HOST_PTR
27572762/// - ::UR_RESULT_ERROR_OUT_OF_HOST_MEMORY
27582763/// - ::UR_RESULT_ERROR_OUT_OF_RESOURCES
@@ -5603,6 +5608,7 @@ typedef enum ur_event_status_t {
56035608 UR_EVENT_STATUS_RUNNING = 1, ///< Command is running
56045609 UR_EVENT_STATUS_SUBMITTED = 2, ///< Command is submitted
56055610 UR_EVENT_STATUS_QUEUED = 3, ///< Command is queued
5611+ UR_EVENT_STATUS_ERROR = 4, ///< Command was abnormally terminated
56065612 /// @cond
56075613 UR_EVENT_STATUS_FORCE_UINT32 = 0x7fffffff
56085614 /// @endcond
@@ -5734,6 +5740,8 @@ urEventGetProfilingInfo(
57345740/// + `NULL == phEventWaitList`
57355741/// - ::UR_RESULT_ERROR_INVALID_VALUE
57365742/// + `numEvents == 0`
5743+ /// - ::UR_RESULT_ERROR_IN_EVENT_LIST_EXEC_STATUS
5744+ /// + An event in `phEventWaitList` has ::UR_EVENT_STATUS_ERROR.
57375745/// - ::UR_RESULT_ERROR_INVALID_EVENT
57385746/// - ::UR_RESULT_ERROR_INVALID_CONTEXT
57395747/// - ::UR_RESULT_ERROR_OUT_OF_HOST_MEMORY
@@ -5949,6 +5957,8 @@ urEventSetCallback(
59495957/// + `phEventWaitList == NULL && numEventsInWaitList > 0`
59505958/// + `phEventWaitList != NULL && numEventsInWaitList == 0`
59515959/// + If event objects in phEventWaitList are not valid events.
5960+ /// - ::UR_RESULT_ERROR_IN_EVENT_LIST_EXEC_STATUS
5961+ /// + An event in `phEventWaitList` has ::UR_EVENT_STATUS_ERROR.
59525962/// - ::UR_RESULT_ERROR_INVALID_WORK_DIMENSION
59535963/// - ::UR_RESULT_ERROR_INVALID_WORK_GROUP_SIZE
59545964/// - ::UR_RESULT_ERROR_INVALID_VALUE
@@ -6005,6 +6015,8 @@ urEnqueueKernelLaunch(
60056015/// + `phEventWaitList == NULL && numEventsInWaitList > 0`
60066016/// + `phEventWaitList != NULL && numEventsInWaitList == 0`
60076017/// + If event objects in phEventWaitList are not valid events.
6018+ /// - ::UR_RESULT_ERROR_IN_EVENT_LIST_EXEC_STATUS
6019+ /// + An event in `phEventWaitList` has ::UR_EVENT_STATUS_ERROR.
60086020/// - ::UR_RESULT_ERROR_INVALID_VALUE
60096021/// - ::UR_RESULT_ERROR_OUT_OF_HOST_MEMORY
60106022/// - ::UR_RESULT_ERROR_OUT_OF_RESOURCES
@@ -6049,6 +6061,8 @@ urEnqueueEventsWait(
60496061/// + `phEventWaitList == NULL && numEventsInWaitList > 0`
60506062/// + `phEventWaitList != NULL && numEventsInWaitList == 0`
60516063/// + If event objects in phEventWaitList are not valid events.
6064+ /// - ::UR_RESULT_ERROR_IN_EVENT_LIST_EXEC_STATUS
6065+ /// + An event in `phEventWaitList` has ::UR_EVENT_STATUS_ERROR.
60526066/// - ::UR_RESULT_ERROR_INVALID_VALUE
60536067/// - ::UR_RESULT_ERROR_OUT_OF_HOST_MEMORY
60546068/// - ::UR_RESULT_ERROR_OUT_OF_RESOURCES
@@ -6092,6 +6106,8 @@ urEnqueueEventsWaitWithBarrier(
60926106/// + `phEventWaitList == NULL && numEventsInWaitList > 0`
60936107/// + `phEventWaitList != NULL && numEventsInWaitList == 0`
60946108/// + If event objects in phEventWaitList are not valid events.
6109+ /// - ::UR_RESULT_ERROR_IN_EVENT_LIST_EXEC_STATUS
6110+ /// + An event in `phEventWaitList` has ::UR_EVENT_STATUS_ERROR.
60956111/// - ::UR_RESULT_ERROR_INVALID_MEM_OBJECT
60966112/// - ::UR_RESULT_ERROR_INVALID_SIZE
60976113/// + If `offset + size` results in an out-of-bounds access.
@@ -6141,6 +6157,8 @@ urEnqueueMemBufferRead(
61416157/// + `phEventWaitList == NULL && numEventsInWaitList > 0`
61426158/// + `phEventWaitList != NULL && numEventsInWaitList == 0`
61436159/// + If event objects in phEventWaitList are not valid events.
6160+ /// - ::UR_RESULT_ERROR_IN_EVENT_LIST_EXEC_STATUS
6161+ /// + An event in `phEventWaitList` has ::UR_EVENT_STATUS_ERROR.
61446162/// - ::UR_RESULT_ERROR_INVALID_MEM_OBJECT
61456163/// - ::UR_RESULT_ERROR_INVALID_SIZE
61466164/// + If `offset + size` results in an out-of-bounds access.
@@ -6193,6 +6211,8 @@ urEnqueueMemBufferWrite(
61936211/// + `phEventWaitList == NULL && numEventsInWaitList > 0`
61946212/// + `phEventWaitList != NULL && numEventsInWaitList == 0`
61956213/// + If event objects in phEventWaitList are not valid events.
6214+ /// - ::UR_RESULT_ERROR_IN_EVENT_LIST_EXEC_STATUS
6215+ /// + An event in `phEventWaitList` has ::UR_EVENT_STATUS_ERROR.
61966216/// - ::UR_RESULT_ERROR_INVALID_MEM_OBJECT
61976217/// - ::UR_RESULT_ERROR_INVALID_SIZE
61986218/// + `region.width == 0 || region.height == 0 || region.width == 0`
@@ -6259,6 +6279,8 @@ urEnqueueMemBufferReadRect(
62596279/// + `phEventWaitList == NULL && numEventsInWaitList > 0`
62606280/// + `phEventWaitList != NULL && numEventsInWaitList == 0`
62616281/// + If event objects in phEventWaitList are not valid events.
6282+ /// - ::UR_RESULT_ERROR_IN_EVENT_LIST_EXEC_STATUS
6283+ /// + An event in `phEventWaitList` has ::UR_EVENT_STATUS_ERROR.
62626284/// - ::UR_RESULT_ERROR_INVALID_MEM_OBJECT
62636285/// - ::UR_RESULT_ERROR_INVALID_SIZE
62646286/// + `region.width == 0 || region.height == 0 || region.width == 0`
@@ -6318,6 +6340,8 @@ urEnqueueMemBufferWriteRect(
63186340/// + `phEventWaitList == NULL && numEventsInWaitList > 0`
63196341/// + `phEventWaitList != NULL && numEventsInWaitList == 0`
63206342/// + If event objects in phEventWaitList are not valid events.
6343+ /// - ::UR_RESULT_ERROR_IN_EVENT_LIST_EXEC_STATUS
6344+ /// + An event in `phEventWaitList` has ::UR_EVENT_STATUS_ERROR.
63216345/// - ::UR_RESULT_ERROR_INVALID_MEM_OBJECT
63226346/// - ::UR_RESULT_ERROR_INVALID_SIZE
63236347/// + If `srcOffset + size` results in an out-of-bounds access.
@@ -6364,6 +6388,8 @@ urEnqueueMemBufferCopy(
63646388/// + `phEventWaitList == NULL && numEventsInWaitList > 0`
63656389/// + `phEventWaitList != NULL && numEventsInWaitList == 0`
63666390/// + If event objects in phEventWaitList are not valid events.
6391+ /// - ::UR_RESULT_ERROR_IN_EVENT_LIST_EXEC_STATUS
6392+ /// + An event in `phEventWaitList` has ::UR_EVENT_STATUS_ERROR.
63676393/// - ::UR_RESULT_ERROR_INVALID_MEM_OBJECT
63686394/// - ::UR_RESULT_ERROR_INVALID_SIZE
63696395/// + `region.width == 0 || region.height == 0 || region.depth == 0`
@@ -6422,6 +6448,8 @@ urEnqueueMemBufferCopyRect(
64226448/// + `phEventWaitList == NULL && numEventsInWaitList > 0`
64236449/// + `phEventWaitList != NULL && numEventsInWaitList == 0`
64246450/// + If event objects in phEventWaitList are not valid events.
6451+ /// - ::UR_RESULT_ERROR_IN_EVENT_LIST_EXEC_STATUS
6452+ /// + An event in `phEventWaitList` has ::UR_EVENT_STATUS_ERROR.
64256453/// - ::UR_RESULT_ERROR_INVALID_MEM_OBJECT
64266454/// - ::UR_RESULT_ERROR_INVALID_SIZE
64276455/// + `patternSize == 0 || size == 0`
@@ -6477,6 +6505,8 @@ urEnqueueMemBufferFill(
64776505/// + `phEventWaitList == NULL && numEventsInWaitList > 0`
64786506/// + `phEventWaitList != NULL && numEventsInWaitList == 0`
64796507/// + If event objects in phEventWaitList are not valid events.
6508+ /// - ::UR_RESULT_ERROR_IN_EVENT_LIST_EXEC_STATUS
6509+ /// + An event in `phEventWaitList` has ::UR_EVENT_STATUS_ERROR.
64806510/// - ::UR_RESULT_ERROR_INVALID_MEM_OBJECT
64816511/// - ::UR_RESULT_ERROR_INVALID_SIZE
64826512/// + `region.width == 0 || region.height == 0 || region.depth == 0`
@@ -6530,6 +6560,8 @@ urEnqueueMemImageRead(
65306560/// + `phEventWaitList == NULL && numEventsInWaitList > 0`
65316561/// + `phEventWaitList != NULL && numEventsInWaitList == 0`
65326562/// + If event objects in phEventWaitList are not valid events.
6563+ /// - ::UR_RESULT_ERROR_IN_EVENT_LIST_EXEC_STATUS
6564+ /// + An event in `phEventWaitList` has ::UR_EVENT_STATUS_ERROR.
65336565/// - ::UR_RESULT_ERROR_INVALID_MEM_OBJECT
65346566/// - ::UR_RESULT_ERROR_INVALID_SIZE
65356567/// + `region.width == 0 || region.height == 0 || region.depth == 0`
@@ -6577,6 +6609,8 @@ urEnqueueMemImageWrite(
65776609/// + `phEventWaitList == NULL && numEventsInWaitList > 0`
65786610/// + `phEventWaitList != NULL && numEventsInWaitList == 0`
65796611/// + If event objects in phEventWaitList are not valid events.
6612+ /// - ::UR_RESULT_ERROR_IN_EVENT_LIST_EXEC_STATUS
6613+ /// + An event in `phEventWaitList` has ::UR_EVENT_STATUS_ERROR.
65806614/// - ::UR_RESULT_ERROR_INVALID_MEM_OBJECT
65816615/// - ::UR_RESULT_ERROR_INVALID_SIZE
65826616/// + `region.width == 0 || region.height == 0 || region.depth == 0`
@@ -6663,6 +6697,8 @@ typedef enum ur_usm_migration_flag_t {
66636697/// + `phEventWaitList == NULL && numEventsInWaitList > 0`
66646698/// + `phEventWaitList != NULL && numEventsInWaitList == 0`
66656699/// + If event objects in phEventWaitList are not valid events.
6700+ /// - ::UR_RESULT_ERROR_IN_EVENT_LIST_EXEC_STATUS
6701+ /// + An event in `phEventWaitList` has ::UR_EVENT_STATUS_ERROR.
66666702/// - ::UR_RESULT_ERROR_INVALID_MEM_OBJECT
66676703/// - ::UR_RESULT_ERROR_INVALID_SIZE
66686704/// + If `offset + size` results in an out-of-bounds access.
@@ -6711,6 +6747,8 @@ urEnqueueMemBufferMap(
67116747/// + `phEventWaitList == NULL && numEventsInWaitList > 0`
67126748/// + `phEventWaitList != NULL && numEventsInWaitList == 0`
67136749/// + If event objects in phEventWaitList are not valid events.
6750+ /// - ::UR_RESULT_ERROR_IN_EVENT_LIST_EXEC_STATUS
6751+ /// + An event in `phEventWaitList` has ::UR_EVENT_STATUS_ERROR.
67146752/// - ::UR_RESULT_ERROR_INVALID_MEM_OBJECT
67156753/// - ::UR_RESULT_ERROR_OUT_OF_HOST_MEMORY
67166754/// - ::UR_RESULT_ERROR_OUT_OF_RESOURCES
@@ -6753,6 +6791,8 @@ urEnqueueMemUnmap(
67536791/// + `phEventWaitList == NULL && numEventsInWaitList > 0`
67546792/// + `phEventWaitList != NULL && numEventsInWaitList == 0`
67556793/// + If event objects in phEventWaitList are not valid events.
6794+ /// - ::UR_RESULT_ERROR_IN_EVENT_LIST_EXEC_STATUS
6795+ /// + An event in `phEventWaitList` has ::UR_EVENT_STATUS_ERROR.
67566796/// - ::UR_RESULT_ERROR_INVALID_MEM_OBJECT
67576797/// - ::UR_RESULT_ERROR_OUT_OF_HOST_MEMORY
67586798/// - ::UR_RESULT_ERROR_OUT_OF_RESOURCES
@@ -6795,6 +6835,8 @@ urEnqueueUSMFill(
67956835/// + `phEventWaitList == NULL && numEventsInWaitList > 0`
67966836/// + `phEventWaitList != NULL && numEventsInWaitList == 0`
67976837/// + If event objects in phEventWaitList are not valid events.
6838+ /// - ::UR_RESULT_ERROR_IN_EVENT_LIST_EXEC_STATUS
6839+ /// + An event in `phEventWaitList` has ::UR_EVENT_STATUS_ERROR.
67986840/// - ::UR_RESULT_ERROR_INVALID_MEM_OBJECT
67996841/// - ::UR_RESULT_ERROR_OUT_OF_HOST_MEMORY
68006842/// - ::UR_RESULT_ERROR_OUT_OF_RESOURCES
@@ -6842,6 +6884,8 @@ urEnqueueUSMMemcpy(
68426884/// + `phEventWaitList == NULL && numEventsInWaitList > 0`
68436885/// + `phEventWaitList != NULL && numEventsInWaitList == 0`
68446886/// + If event objects in phEventWaitList are not valid events.
6887+ /// - ::UR_RESULT_ERROR_IN_EVENT_LIST_EXEC_STATUS
6888+ /// + An event in `phEventWaitList` has ::UR_EVENT_STATUS_ERROR.
68456889/// - ::UR_RESULT_ERROR_INVALID_MEM_OBJECT
68466890/// - ::UR_RESULT_ERROR_OUT_OF_HOST_MEMORY
68476891/// - ::UR_RESULT_ERROR_OUT_OF_RESOURCES
@@ -6924,6 +6968,8 @@ urEnqueueUSMAdvise(
69246968/// + `phEventWaitList == NULL && numEventsInWaitList > 0`
69256969/// + `phEventWaitList != NULL && numEventsInWaitList == 0`
69266970/// + If event objects in phEventWaitList are not valid events.
6971+ /// - ::UR_RESULT_ERROR_IN_EVENT_LIST_EXEC_STATUS
6972+ /// + An event in `phEventWaitList` has ::UR_EVENT_STATUS_ERROR.
69276973/// - ::UR_RESULT_ERROR_INVALID_MEM_OBJECT
69286974/// - ::UR_RESULT_ERROR_OUT_OF_HOST_MEMORY
69296975/// - ::UR_RESULT_ERROR_OUT_OF_RESOURCES
@@ -6973,6 +7019,8 @@ urEnqueueUSMFill2D(
69737019/// + `phEventWaitList == NULL && numEventsInWaitList > 0`
69747020/// + `phEventWaitList != NULL && numEventsInWaitList == 0`
69757021/// + If event objects in phEventWaitList are not valid events.
7022+ /// - ::UR_RESULT_ERROR_IN_EVENT_LIST_EXEC_STATUS
7023+ /// + An event in `phEventWaitList` has ::UR_EVENT_STATUS_ERROR.
69767024/// - ::UR_RESULT_ERROR_INVALID_MEM_OBJECT
69777025/// - ::UR_RESULT_ERROR_OUT_OF_HOST_MEMORY
69787026/// - ::UR_RESULT_ERROR_OUT_OF_RESOURCES
@@ -7016,6 +7064,8 @@ urEnqueueUSMMemcpy2D(
70167064/// + `phEventWaitList == NULL && numEventsInWaitList > 0`
70177065/// + `phEventWaitList != NULL && numEventsInWaitList == 0`
70187066/// + If event objects in phEventWaitList are not valid events.
7067+ /// - ::UR_RESULT_ERROR_IN_EVENT_LIST_EXEC_STATUS
7068+ /// + An event in `phEventWaitList` has ::UR_EVENT_STATUS_ERROR.
70197069UR_APIEXPORT ur_result_t UR_APICALL
70207070urEnqueueDeviceGlobalVariableWrite(
70217071 ur_queue_handle_t hQueue, ///< [in] handle of the queue to submit to.
@@ -7053,6 +7103,8 @@ urEnqueueDeviceGlobalVariableWrite(
70537103/// + `phEventWaitList == NULL && numEventsInWaitList > 0`
70547104/// + `phEventWaitList != NULL && numEventsInWaitList == 0`
70557105/// + If event objects in phEventWaitList are not valid events.
7106+ /// - ::UR_RESULT_ERROR_IN_EVENT_LIST_EXEC_STATUS
7107+ /// + An event in `phEventWaitList` has ::UR_EVENT_STATUS_ERROR.
70567108UR_APIEXPORT ur_result_t UR_APICALL
70577109urEnqueueDeviceGlobalVariableRead(
70587110 ur_queue_handle_t hQueue, ///< [in] handle of the queue to submit to.
@@ -7089,6 +7141,8 @@ urEnqueueDeviceGlobalVariableRead(
70897141/// + `phEventWaitList == NULL && numEventsInWaitList > 0`
70907142/// + `phEventWaitList != NULL && numEventsInWaitList == 0`
70917143/// + If event objects in phEventWaitList are not valid events.
7144+ /// - ::UR_RESULT_ERROR_IN_EVENT_LIST_EXEC_STATUS
7145+ /// + An event in `phEventWaitList` has ::UR_EVENT_STATUS_ERROR.
70927146UR_APIEXPORT ur_result_t UR_APICALL
70937147urEnqueueReadHostPipe(
70947148 ur_queue_handle_t hQueue, ///< [in] a valid host command-queue in which the read command
@@ -7127,6 +7181,8 @@ urEnqueueReadHostPipe(
71277181/// + `phEventWaitList == NULL && numEventsInWaitList > 0`
71287182/// + `phEventWaitList != NULL && numEventsInWaitList == 0`
71297183/// + If event objects in phEventWaitList are not valid events.
7184+ /// - ::UR_RESULT_ERROR_IN_EVENT_LIST_EXEC_STATUS
7185+ /// + An event in `phEventWaitList` has ::UR_EVENT_STATUS_ERROR.
71307186UR_APIEXPORT ur_result_t UR_APICALL
71317187urEnqueueWriteHostPipe(
71327188 ur_queue_handle_t hQueue, ///< [in] a valid host command-queue in which the write command
0 commit comments