@@ -272,7 +272,6 @@ typedef enum ur_structure_type_t {
272272 UR_STRUCTURE_TYPE_EXP_COMMAND_BUFFER_UPDATE_MEMOBJ_ARG_DESC = 0x1002, ///< ::ur_exp_command_buffer_update_memobj_arg_desc_t
273273 UR_STRUCTURE_TYPE_EXP_COMMAND_BUFFER_UPDATE_POINTER_ARG_DESC = 0x1003, ///< ::ur_exp_command_buffer_update_pointer_arg_desc_t
274274 UR_STRUCTURE_TYPE_EXP_COMMAND_BUFFER_UPDATE_VALUE_ARG_DESC = 0x1004, ///< ::ur_exp_command_buffer_update_value_arg_desc_t
275- UR_STRUCTURE_TYPE_EXP_COMMAND_BUFFER_UPDATE_EXEC_INFO_DESC = 0x1005, ///< ::ur_exp_command_buffer_update_exec_info_desc_t
276275 UR_STRUCTURE_TYPE_EXP_SAMPLER_MIP_PROPERTIES = 0x2000, ///< ::ur_exp_sampler_mip_properties_t
277276 UR_STRUCTURE_TYPE_EXP_INTEROP_MEM_DESC = 0x2001, ///< ::ur_exp_interop_mem_desc_t
278277 UR_STRUCTURE_TYPE_EXP_INTEROP_SEMAPHORE_DESC = 0x2002, ///< ::ur_exp_interop_semaphore_desc_t
@@ -8060,19 +8059,6 @@ typedef struct ur_exp_command_buffer_update_value_arg_desc_t {
80608059
80618060} ur_exp_command_buffer_update_value_arg_desc_t;
80628061
8063- ///////////////////////////////////////////////////////////////////////////////
8064- /// @brief Descriptor type for updating kernel command execution info.
8065- typedef struct ur_exp_command_buffer_update_exec_info_desc_t {
8066- ur_structure_type_t stype; ///< [in] type of this structure, must be
8067- ///< ::UR_STRUCTURE_TYPE_EXP_COMMAND_BUFFER_UPDATE_EXEC_INFO_DESC
8068- const void *pNext; ///< [in][optional] pointer to extension-specific structure
8069- ur_kernel_exec_info_t propName; ///< [in] Name of execution attribute.
8070- size_t propSize; ///< [in] Size of execution attribute.
8071- const ur_kernel_exec_info_properties_t *pProperties; ///< [in][optional] Pointer to execution info properties.
8072- const void *pNewExecInfo; ///< [in] Pointer to memory location holding the execution info value.
8073-
8074- } ur_exp_command_buffer_update_exec_info_desc_t;
8075-
80768062///////////////////////////////////////////////////////////////////////////////
80778063/// @brief Descriptor type for updating a kernel launch command.
80788064typedef struct ur_exp_command_buffer_update_kernel_launch_desc_t {
@@ -8082,24 +8068,23 @@ typedef struct ur_exp_command_buffer_update_kernel_launch_desc_t {
80828068 uint32_t numNewMemObjArgs; ///< [in] Length of pNewMemObjArgList.
80838069 uint32_t numNewPointerArgs; ///< [in] Length of pNewPointerArgList.
80848070 uint32_t numNewValueArgs; ///< [in] Length of pNewValueArgList.
8085- uint32_t numNewExecInfos; ///< [in] Length of pNewExecInfoList.
80868071 uint32_t newWorkDim; ///< [in] Number of work dimensions in the kernel ND-range, from 1-3.
80878072 const ur_exp_command_buffer_update_memobj_arg_desc_t *pNewMemObjArgList; ///< [in][optional][range(0, numNewMemObjArgs)] An array describing the new
80888073 ///< kernel mem obj arguments for the command.
80898074 const ur_exp_command_buffer_update_pointer_arg_desc_t *pNewPointerArgList; ///< [in][optional][range(0, numNewPointerArgs)] An array describing the
80908075 ///< new kernel pointer arguments for the command.
80918076 const ur_exp_command_buffer_update_value_arg_desc_t *pNewValueArgList; ///< [in][optional][range(0, numNewValueArgs)] An array describing the new
80928077 ///< kernel value arguments for the command.
8093- const ur_exp_command_buffer_update_exec_info_desc_t *pNewExecInfoList; ///< [in][optional][range(0, numNewExecInfos)] An array describing the
8094- ///< execution info objects for the command.
80958078 size_t *pNewGlobalWorkOffset; ///< [in][optional][range(0, newWorkDim)] Array of newWorkDim unsigned
80968079 ///< values that describe the offset used to calculate the global ID.
80978080 size_t *pNewGlobalWorkSize; ///< [in][optional][range(0, newWorkDim)] Array of newWorkDim unsigned
80988081 ///< values that describe the number of global work-items.
80998082 size_t *pNewLocalWorkSize; ///< [in][optional][range(0, newWorkDim)] Array of newWorkDim unsigned
81008083 ///< values that describe the number of work-items that make up a
8101- ///< work-group. If nullptr, the runtime implementation will choose the
8102- ///< work-group size.
8084+ ///< work-group. If newWorkDim is non-zero and pNewLocalWorkSize is
8085+ ///< nullptr, then runtime implementation will choose the work-group size.
8086+ ///< If newWorkDim is zero and pNewLocalWorkSize is nullptr, then the local
8087+ ///< work size is unchanged.
81038088
81048089} ur_exp_command_buffer_update_kernel_launch_desc_t;
81058090
@@ -8134,6 +8119,8 @@ typedef struct ur_exp_command_buffer_command_handle_t_ *ur_exp_command_buffer_co
81348119/// + `NULL == phCommandBuffer`
81358120/// - ::UR_RESULT_ERROR_INVALID_CONTEXT
81368121/// - ::UR_RESULT_ERROR_INVALID_DEVICE
8122+ /// - ::UR_RESULT_ERROR_INVALID_OPERATION
8123+ /// + If `pCommandBufferDesc->isUpdatable` is true and `hDevice` does not support UR_DEVICE_INFO_COMMAND_BUFFER_UPDATE_SUPPORT_EXP.
81378124/// - ::UR_RESULT_ERROR_OUT_OF_HOST_MEMORY
81388125/// - ::UR_RESULT_ERROR_OUT_OF_RESOURCES
81398126UR_APIEXPORT ur_result_t UR_APICALL
@@ -8214,7 +8201,6 @@ urCommandBufferFinalizeExp(
82148201/// - ::UR_RESULT_ERROR_INVALID_NULL_POINTER
82158202/// + `NULL == pGlobalWorkOffset`
82168203/// + `NULL == pGlobalWorkSize`
8217- /// + `NULL == pLocalWorkSize`
82188204/// - ::UR_RESULT_ERROR_INVALID_COMMAND_BUFFER_EXP
82198205/// - ::UR_RESULT_ERROR_INVALID_KERNEL
82208206/// - ::UR_RESULT_ERROR_INVALID_WORK_DIMENSION
@@ -8233,7 +8219,7 @@ urCommandBufferAppendKernelLaunchExp(
82338219 uint32_t workDim, ///< [in] Dimension of the kernel execution.
82348220 const size_t *pGlobalWorkOffset, ///< [in] Offset to use when executing kernel.
82358221 const size_t *pGlobalWorkSize, ///< [in] Global work size to use when executing kernel.
8236- const size_t *pLocalWorkSize, ///< [in] Local work size to use when executing kernel.
8222+ const size_t *pLocalWorkSize, ///< [in][optional] Local work size to use when executing kernel.
82378223 uint32_t numSyncPointsInWaitList, ///< [in] The number of sync points in the provided dependency list.
82388224 const ur_exp_command_buffer_sync_point_t *pSyncPointWaitList, ///< [in][optional] A list of sync points that this command depends on.
82398225 ur_exp_command_buffer_sync_point_t *pSyncPoint, ///< [out][optional] Sync point associated with this command.
@@ -8735,6 +8721,10 @@ urCommandBufferReleaseCommandExp(
87358721/// - ::UR_RESULT_ERROR_INVALID_OPERATION
87368722/// + If ::ur_exp_command_buffer_desc_t::isUpdatable was not set to true on creation of the command buffer `hCommand` belongs to.
87378723/// + If the command-buffer `hCommand` belongs to has not been finalized.
8724+ /// + If `pUpdateKernellaunch->newWorkDim` is non-zero and different from the work-dim used on creation of `hCommand`.
8725+ /// + If `pUpdateKernellaunch->newWorkDim` is non-zero and `pUpdateKernelLaunch->pNewLocalWorkSize` is set to a non-NULL value and `pUpdateKernelLaunch->pNewGlobalWorkSize` is NULL.
8726+ /// + If `pUpdateKernellaunch->newWorkDim` is non-zero and `pUpdateKernelLaunch->pNewLocalWorkSize` is set to a non-NULL value when `hCommand` was created with a NULL local work size.
8727+ /// + If `pUpdateKernellaunch->newWorkDim` is non-zero and `pUpdateKernelLaunch->pNewLocalWorkSize` is set to a NULL value when `hCommand` was created with a non-NULL local work size.
87388728/// - ::UR_RESULT_ERROR_INVALID_COMMAND_BUFFER_COMMAND_HANDLE_EXP
87398729/// - ::UR_RESULT_ERROR_INVALID_MEM_OBJECT
87408730/// - ::UR_RESULT_ERROR_INVALID_KERNEL_ARGUMENT_INDEX
0 commit comments