@@ -492,6 +492,8 @@ typedef enum ur_result_t {
492
492
UR_RESULT_ERROR_ADAPTER_SPECIFIC = 67, ///< An adapter specific warning/error has been reported and can be
493
493
///< retrieved via the urPlatformGetLastError entry point.
494
494
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`
495
497
UR_RESULT_ERROR_INVALID_COMMAND_BUFFER_EXP = 0x1000, ///< Invalid Command-Buffer
496
498
UR_RESULT_ERROR_INVALID_COMMAND_BUFFER_SYNC_POINT_EXP = 0x1001, ///< Sync point is not valid for the command-buffer
497
499
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 {
2645
2647
/// - ::UR_RESULT_ERROR_INVALID_CONTEXT
2646
2648
/// - ::UR_RESULT_ERROR_INVALID_VALUE
2647
2649
/// - ::UR_RESULT_ERROR_INVALID_BUFFER_SIZE
2650
+ /// + `size == 0`
2648
2651
/// - ::UR_RESULT_ERROR_INVALID_HOST_PTR
2649
2652
/// + `pProperties == NULL && (flags & (UR_MEM_FLAG_USE_HOST_POINTER | UR_MEM_FLAG_ALLOC_COPY_HOST_POINTER)) != 0`
2650
2653
/// + `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 {
2753
2756
/// - ::UR_RESULT_ERROR_OBJECT_ALLOCATION_FAILURE
2754
2757
/// - ::UR_RESULT_ERROR_INVALID_VALUE
2755
2758
/// - ::UR_RESULT_ERROR_INVALID_BUFFER_SIZE
2759
+ /// + `pRegion && pRegion->size == 0`
2760
+ /// + hBuffer allocation size < (pRegion->origin + pRegion->size)
2756
2761
/// - ::UR_RESULT_ERROR_INVALID_HOST_PTR
2757
2762
/// - ::UR_RESULT_ERROR_OUT_OF_HOST_MEMORY
2758
2763
/// - ::UR_RESULT_ERROR_OUT_OF_RESOURCES
@@ -5603,6 +5608,7 @@ typedef enum ur_event_status_t {
5603
5608
UR_EVENT_STATUS_RUNNING = 1, ///< Command is running
5604
5609
UR_EVENT_STATUS_SUBMITTED = 2, ///< Command is submitted
5605
5610
UR_EVENT_STATUS_QUEUED = 3, ///< Command is queued
5611
+ UR_EVENT_STATUS_ERROR = 4, ///< Command was abnormally terminated
5606
5612
/// @cond
5607
5613
UR_EVENT_STATUS_FORCE_UINT32 = 0x7fffffff
5608
5614
/// @endcond
@@ -5734,6 +5740,8 @@ urEventGetProfilingInfo(
5734
5740
/// + `NULL == phEventWaitList`
5735
5741
/// - ::UR_RESULT_ERROR_INVALID_VALUE
5736
5742
/// + `numEvents == 0`
5743
+ /// - ::UR_RESULT_ERROR_IN_EVENT_LIST_EXEC_STATUS
5744
+ /// + An event in `phEventWaitList` has ::UR_EVENT_STATUS_ERROR.
5737
5745
/// - ::UR_RESULT_ERROR_INVALID_EVENT
5738
5746
/// - ::UR_RESULT_ERROR_INVALID_CONTEXT
5739
5747
/// - ::UR_RESULT_ERROR_OUT_OF_HOST_MEMORY
@@ -5949,6 +5957,8 @@ urEventSetCallback(
5949
5957
/// + `phEventWaitList == NULL && numEventsInWaitList > 0`
5950
5958
/// + `phEventWaitList != NULL && numEventsInWaitList == 0`
5951
5959
/// + 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.
5952
5962
/// - ::UR_RESULT_ERROR_INVALID_WORK_DIMENSION
5953
5963
/// - ::UR_RESULT_ERROR_INVALID_WORK_GROUP_SIZE
5954
5964
/// - ::UR_RESULT_ERROR_INVALID_VALUE
@@ -6005,6 +6015,8 @@ urEnqueueKernelLaunch(
6005
6015
/// + `phEventWaitList == NULL && numEventsInWaitList > 0`
6006
6016
/// + `phEventWaitList != NULL && numEventsInWaitList == 0`
6007
6017
/// + 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.
6008
6020
/// - ::UR_RESULT_ERROR_INVALID_VALUE
6009
6021
/// - ::UR_RESULT_ERROR_OUT_OF_HOST_MEMORY
6010
6022
/// - ::UR_RESULT_ERROR_OUT_OF_RESOURCES
@@ -6049,6 +6061,8 @@ urEnqueueEventsWait(
6049
6061
/// + `phEventWaitList == NULL && numEventsInWaitList > 0`
6050
6062
/// + `phEventWaitList != NULL && numEventsInWaitList == 0`
6051
6063
/// + 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.
6052
6066
/// - ::UR_RESULT_ERROR_INVALID_VALUE
6053
6067
/// - ::UR_RESULT_ERROR_OUT_OF_HOST_MEMORY
6054
6068
/// - ::UR_RESULT_ERROR_OUT_OF_RESOURCES
@@ -6092,6 +6106,8 @@ urEnqueueEventsWaitWithBarrier(
6092
6106
/// + `phEventWaitList == NULL && numEventsInWaitList > 0`
6093
6107
/// + `phEventWaitList != NULL && numEventsInWaitList == 0`
6094
6108
/// + 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.
6095
6111
/// - ::UR_RESULT_ERROR_INVALID_MEM_OBJECT
6096
6112
/// - ::UR_RESULT_ERROR_INVALID_SIZE
6097
6113
/// + If `offset + size` results in an out-of-bounds access.
@@ -6141,6 +6157,8 @@ urEnqueueMemBufferRead(
6141
6157
/// + `phEventWaitList == NULL && numEventsInWaitList > 0`
6142
6158
/// + `phEventWaitList != NULL && numEventsInWaitList == 0`
6143
6159
/// + 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.
6144
6162
/// - ::UR_RESULT_ERROR_INVALID_MEM_OBJECT
6145
6163
/// - ::UR_RESULT_ERROR_INVALID_SIZE
6146
6164
/// + If `offset + size` results in an out-of-bounds access.
@@ -6193,6 +6211,8 @@ urEnqueueMemBufferWrite(
6193
6211
/// + `phEventWaitList == NULL && numEventsInWaitList > 0`
6194
6212
/// + `phEventWaitList != NULL && numEventsInWaitList == 0`
6195
6213
/// + 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.
6196
6216
/// - ::UR_RESULT_ERROR_INVALID_MEM_OBJECT
6197
6217
/// - ::UR_RESULT_ERROR_INVALID_SIZE
6198
6218
/// + `region.width == 0 || region.height == 0 || region.width == 0`
@@ -6259,6 +6279,8 @@ urEnqueueMemBufferReadRect(
6259
6279
/// + `phEventWaitList == NULL && numEventsInWaitList > 0`
6260
6280
/// + `phEventWaitList != NULL && numEventsInWaitList == 0`
6261
6281
/// + 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.
6262
6284
/// - ::UR_RESULT_ERROR_INVALID_MEM_OBJECT
6263
6285
/// - ::UR_RESULT_ERROR_INVALID_SIZE
6264
6286
/// + `region.width == 0 || region.height == 0 || region.width == 0`
@@ -6318,6 +6340,8 @@ urEnqueueMemBufferWriteRect(
6318
6340
/// + `phEventWaitList == NULL && numEventsInWaitList > 0`
6319
6341
/// + `phEventWaitList != NULL && numEventsInWaitList == 0`
6320
6342
/// + 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.
6321
6345
/// - ::UR_RESULT_ERROR_INVALID_MEM_OBJECT
6322
6346
/// - ::UR_RESULT_ERROR_INVALID_SIZE
6323
6347
/// + If `srcOffset + size` results in an out-of-bounds access.
@@ -6364,6 +6388,8 @@ urEnqueueMemBufferCopy(
6364
6388
/// + `phEventWaitList == NULL && numEventsInWaitList > 0`
6365
6389
/// + `phEventWaitList != NULL && numEventsInWaitList == 0`
6366
6390
/// + 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.
6367
6393
/// - ::UR_RESULT_ERROR_INVALID_MEM_OBJECT
6368
6394
/// - ::UR_RESULT_ERROR_INVALID_SIZE
6369
6395
/// + `region.width == 0 || region.height == 0 || region.depth == 0`
@@ -6422,6 +6448,8 @@ urEnqueueMemBufferCopyRect(
6422
6448
/// + `phEventWaitList == NULL && numEventsInWaitList > 0`
6423
6449
/// + `phEventWaitList != NULL && numEventsInWaitList == 0`
6424
6450
/// + 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.
6425
6453
/// - ::UR_RESULT_ERROR_INVALID_MEM_OBJECT
6426
6454
/// - ::UR_RESULT_ERROR_INVALID_SIZE
6427
6455
/// + `patternSize == 0 || size == 0`
@@ -6477,6 +6505,8 @@ urEnqueueMemBufferFill(
6477
6505
/// + `phEventWaitList == NULL && numEventsInWaitList > 0`
6478
6506
/// + `phEventWaitList != NULL && numEventsInWaitList == 0`
6479
6507
/// + 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.
6480
6510
/// - ::UR_RESULT_ERROR_INVALID_MEM_OBJECT
6481
6511
/// - ::UR_RESULT_ERROR_INVALID_SIZE
6482
6512
/// + `region.width == 0 || region.height == 0 || region.depth == 0`
@@ -6530,6 +6560,8 @@ urEnqueueMemImageRead(
6530
6560
/// + `phEventWaitList == NULL && numEventsInWaitList > 0`
6531
6561
/// + `phEventWaitList != NULL && numEventsInWaitList == 0`
6532
6562
/// + 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.
6533
6565
/// - ::UR_RESULT_ERROR_INVALID_MEM_OBJECT
6534
6566
/// - ::UR_RESULT_ERROR_INVALID_SIZE
6535
6567
/// + `region.width == 0 || region.height == 0 || region.depth == 0`
@@ -6577,6 +6609,8 @@ urEnqueueMemImageWrite(
6577
6609
/// + `phEventWaitList == NULL && numEventsInWaitList > 0`
6578
6610
/// + `phEventWaitList != NULL && numEventsInWaitList == 0`
6579
6611
/// + 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.
6580
6614
/// - ::UR_RESULT_ERROR_INVALID_MEM_OBJECT
6581
6615
/// - ::UR_RESULT_ERROR_INVALID_SIZE
6582
6616
/// + `region.width == 0 || region.height == 0 || region.depth == 0`
@@ -6663,6 +6697,8 @@ typedef enum ur_usm_migration_flag_t {
6663
6697
/// + `phEventWaitList == NULL && numEventsInWaitList > 0`
6664
6698
/// + `phEventWaitList != NULL && numEventsInWaitList == 0`
6665
6699
/// + 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.
6666
6702
/// - ::UR_RESULT_ERROR_INVALID_MEM_OBJECT
6667
6703
/// - ::UR_RESULT_ERROR_INVALID_SIZE
6668
6704
/// + If `offset + size` results in an out-of-bounds access.
@@ -6711,6 +6747,8 @@ urEnqueueMemBufferMap(
6711
6747
/// + `phEventWaitList == NULL && numEventsInWaitList > 0`
6712
6748
/// + `phEventWaitList != NULL && numEventsInWaitList == 0`
6713
6749
/// + 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.
6714
6752
/// - ::UR_RESULT_ERROR_INVALID_MEM_OBJECT
6715
6753
/// - ::UR_RESULT_ERROR_OUT_OF_HOST_MEMORY
6716
6754
/// - ::UR_RESULT_ERROR_OUT_OF_RESOURCES
@@ -6753,6 +6791,8 @@ urEnqueueMemUnmap(
6753
6791
/// + `phEventWaitList == NULL && numEventsInWaitList > 0`
6754
6792
/// + `phEventWaitList != NULL && numEventsInWaitList == 0`
6755
6793
/// + 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.
6756
6796
/// - ::UR_RESULT_ERROR_INVALID_MEM_OBJECT
6757
6797
/// - ::UR_RESULT_ERROR_OUT_OF_HOST_MEMORY
6758
6798
/// - ::UR_RESULT_ERROR_OUT_OF_RESOURCES
@@ -6795,6 +6835,8 @@ urEnqueueUSMFill(
6795
6835
/// + `phEventWaitList == NULL && numEventsInWaitList > 0`
6796
6836
/// + `phEventWaitList != NULL && numEventsInWaitList == 0`
6797
6837
/// + 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.
6798
6840
/// - ::UR_RESULT_ERROR_INVALID_MEM_OBJECT
6799
6841
/// - ::UR_RESULT_ERROR_OUT_OF_HOST_MEMORY
6800
6842
/// - ::UR_RESULT_ERROR_OUT_OF_RESOURCES
@@ -6842,6 +6884,8 @@ urEnqueueUSMMemcpy(
6842
6884
/// + `phEventWaitList == NULL && numEventsInWaitList > 0`
6843
6885
/// + `phEventWaitList != NULL && numEventsInWaitList == 0`
6844
6886
/// + 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.
6845
6889
/// - ::UR_RESULT_ERROR_INVALID_MEM_OBJECT
6846
6890
/// - ::UR_RESULT_ERROR_OUT_OF_HOST_MEMORY
6847
6891
/// - ::UR_RESULT_ERROR_OUT_OF_RESOURCES
@@ -6924,6 +6968,8 @@ urEnqueueUSMAdvise(
6924
6968
/// + `phEventWaitList == NULL && numEventsInWaitList > 0`
6925
6969
/// + `phEventWaitList != NULL && numEventsInWaitList == 0`
6926
6970
/// + 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.
6927
6973
/// - ::UR_RESULT_ERROR_INVALID_MEM_OBJECT
6928
6974
/// - ::UR_RESULT_ERROR_OUT_OF_HOST_MEMORY
6929
6975
/// - ::UR_RESULT_ERROR_OUT_OF_RESOURCES
@@ -6973,6 +7019,8 @@ urEnqueueUSMFill2D(
6973
7019
/// + `phEventWaitList == NULL && numEventsInWaitList > 0`
6974
7020
/// + `phEventWaitList != NULL && numEventsInWaitList == 0`
6975
7021
/// + 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.
6976
7024
/// - ::UR_RESULT_ERROR_INVALID_MEM_OBJECT
6977
7025
/// - ::UR_RESULT_ERROR_OUT_OF_HOST_MEMORY
6978
7026
/// - ::UR_RESULT_ERROR_OUT_OF_RESOURCES
@@ -7016,6 +7064,8 @@ urEnqueueUSMMemcpy2D(
7016
7064
/// + `phEventWaitList == NULL && numEventsInWaitList > 0`
7017
7065
/// + `phEventWaitList != NULL && numEventsInWaitList == 0`
7018
7066
/// + 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.
7019
7069
UR_APIEXPORT ur_result_t UR_APICALL
7020
7070
urEnqueueDeviceGlobalVariableWrite(
7021
7071
ur_queue_handle_t hQueue, ///< [in] handle of the queue to submit to.
@@ -7053,6 +7103,8 @@ urEnqueueDeviceGlobalVariableWrite(
7053
7103
/// + `phEventWaitList == NULL && numEventsInWaitList > 0`
7054
7104
/// + `phEventWaitList != NULL && numEventsInWaitList == 0`
7055
7105
/// + 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.
7056
7108
UR_APIEXPORT ur_result_t UR_APICALL
7057
7109
urEnqueueDeviceGlobalVariableRead(
7058
7110
ur_queue_handle_t hQueue, ///< [in] handle of the queue to submit to.
@@ -7089,6 +7141,8 @@ urEnqueueDeviceGlobalVariableRead(
7089
7141
/// + `phEventWaitList == NULL && numEventsInWaitList > 0`
7090
7142
/// + `phEventWaitList != NULL && numEventsInWaitList == 0`
7091
7143
/// + 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.
7092
7146
UR_APIEXPORT ur_result_t UR_APICALL
7093
7147
urEnqueueReadHostPipe(
7094
7148
ur_queue_handle_t hQueue, ///< [in] a valid host command-queue in which the read command
@@ -7127,6 +7181,8 @@ urEnqueueReadHostPipe(
7127
7181
/// + `phEventWaitList == NULL && numEventsInWaitList > 0`
7128
7182
/// + `phEventWaitList != NULL && numEventsInWaitList == 0`
7129
7183
/// + 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.
7130
7186
UR_APIEXPORT ur_result_t UR_APICALL
7131
7187
urEnqueueWriteHostPipe(
7132
7188
ur_queue_handle_t hQueue, ///< [in] a valid host command-queue in which the write command
0 commit comments