@@ -224,48 +224,48 @@ typedef enum ur_function_t {
224224///////////////////////////////////////////////////////////////////////////////
225225/// @brief Defines structure types
226226typedef enum ur_structure_type_t {
227- UR_STRUCTURE_TYPE_CONTEXT_PROPERTIES = 0, ///< ::ur_context_properties_t
228- UR_STRUCTURE_TYPE_IMAGE_DESC = 1, ///< ::ur_image_desc_t
229- UR_STRUCTURE_TYPE_BUFFER_PROPERTIES = 2, ///< ::ur_buffer_properties_t
230- UR_STRUCTURE_TYPE_BUFFER_REGION = 3, ///< ::ur_buffer_region_t
231- UR_STRUCTURE_TYPE_BUFFER_CHANNEL_PROPERTIES = 4, ///< ::ur_buffer_channel_properties_t
232- UR_STRUCTURE_TYPE_BUFFER_ALLOC_LOCATION_PROPERTIES = 5, ///< ::ur_buffer_alloc_location_properties_t
233- UR_STRUCTURE_TYPE_PROGRAM_PROPERTIES = 6, ///< ::ur_program_properties_t
234- UR_STRUCTURE_TYPE_USM_DESC = 7, ///< ::ur_usm_desc_t
235- UR_STRUCTURE_TYPE_USM_HOST_DESC = 8, ///< ::ur_usm_host_desc_t
236- UR_STRUCTURE_TYPE_USM_DEVICE_DESC = 9, ///< ::ur_usm_device_desc_t
237- UR_STRUCTURE_TYPE_USM_POOL_DESC = 10, ///< ::ur_usm_pool_desc_t
238- UR_STRUCTURE_TYPE_USM_POOL_LIMITS_DESC = 11, ///< ::ur_usm_pool_limits_desc_t
239- UR_STRUCTURE_TYPE_DEVICE_BINARY = 12, ///< ::ur_device_binary_t
240- UR_STRUCTURE_TYPE_SAMPLER_DESC = 13, ///< ::ur_sampler_desc_t
241- UR_STRUCTURE_TYPE_QUEUE_PROPERTIES = 14, ///< ::ur_queue_properties_t
242- UR_STRUCTURE_TYPE_QUEUE_INDEX_PROPERTIES = 15, ///< ::ur_queue_index_properties_t
243- UR_STRUCTURE_TYPE_CONTEXT_NATIVE_PROPERTIES = 16, ///< ::ur_context_native_properties_t
244- UR_STRUCTURE_TYPE_KERNEL_NATIVE_PROPERTIES = 17, ///< ::ur_kernel_native_properties_t
245- UR_STRUCTURE_TYPE_QUEUE_NATIVE_PROPERTIES = 18, ///< ::ur_queue_native_properties_t
246- UR_STRUCTURE_TYPE_MEM_NATIVE_PROPERTIES = 19, ///< ::ur_mem_native_properties_t
247- UR_STRUCTURE_TYPE_EVENT_NATIVE_PROPERTIES = 20, ///< ::ur_event_native_properties_t
248- UR_STRUCTURE_TYPE_PLATFORM_NATIVE_PROPERTIES = 21, ///< ::ur_platform_native_properties_t
249- UR_STRUCTURE_TYPE_DEVICE_NATIVE_PROPERTIES = 22, ///< ::ur_device_native_properties_t
250- UR_STRUCTURE_TYPE_PROGRAM_NATIVE_PROPERTIES = 23, ///< ::ur_program_native_properties_t
251- UR_STRUCTURE_TYPE_SAMPLER_NATIVE_PROPERTIES = 24, ///< ::ur_sampler_native_properties_t
252- UR_STRUCTURE_TYPE_QUEUE_NATIVE_DESC = 25, ///< ::ur_queue_native_desc_t
253- UR_STRUCTURE_TYPE_DEVICE_PARTITION_PROPERTIES = 26, ///< ::ur_device_partition_properties_t
254- UR_STRUCTURE_TYPE_KERNEL_ARG_MEM_OBJ_PROPERTIES = 27, ///< ::ur_kernel_arg_mem_obj_properties_t
255- UR_STRUCTURE_TYPE_PHYSICAL_MEM_PROPERTIES = 28, ///< ::ur_physical_mem_properties_t
256- UR_STRUCTURE_TYPE_KERNEL_ARG_POINTER_PROPERTIES = 29, ///< ::ur_kernel_arg_pointer_properties_t
257- UR_STRUCTURE_TYPE_KERNEL_ARG_SAMPLER_PROPERTIES = 30, ///< ::ur_kernel_arg_sampler_properties_t
258- UR_STRUCTURE_TYPE_KERNEL_EXEC_INFO_PROPERTIES = 31, ///< ::ur_kernel_exec_info_properties_t
259- UR_STRUCTURE_TYPE_KERNEL_ARG_VALUE_PROPERTIES = 32, ///< ::ur_kernel_arg_value_properties_t
260- UR_STRUCTURE_TYPE_KERNEL_ARG_LOCAL_PROPERTIES = 33, ///< ::ur_kernel_arg_local_properties_t
261- UR_STRUCTURE_TYPE_EXP_COMMAND_BUFFER_DESC = 0x1000 , ///< ::ur_exp_command_buffer_desc_t
262- UR_STRUCTURE_TYPE_EXP_SAMPLER_MIP_PROPERTIES = 0x2000 , ///< ::ur_exp_sampler_mip_properties_t
263- UR_STRUCTURE_TYPE_EXP_INTEROP_MEM_DESC = 0x2001 , ///< ::ur_exp_interop_mem_desc_t
264- UR_STRUCTURE_TYPE_EXP_INTEROP_SEMAPHORE_DESC = 0x2002 , ///< ::ur_exp_interop_semaphore_desc_t
265- UR_STRUCTURE_TYPE_EXP_FILE_DESCRIPTOR = 0x2003 , ///< ::ur_exp_file_descriptor_t
266- UR_STRUCTURE_TYPE_EXP_WIN32_HANDLE = 0x2004 , ///< ::ur_exp_win32_handle_t
267- UR_STRUCTURE_TYPE_EXP_LAYERED_IMAGE_PROPERTIES = 0x2005, ///< ::ur_exp_layered_image_properties_t
268- UR_STRUCTURE_TYPE_EXP_SAMPLER_ADDR_MODES = 0x2006, ///< ::ur_exp_sampler_addr_modes_t
227+ UR_STRUCTURE_TYPE_CONTEXT_PROPERTIES = 0, ///< ::ur_context_properties_t
228+ UR_STRUCTURE_TYPE_IMAGE_DESC = 1, ///< ::ur_image_desc_t
229+ UR_STRUCTURE_TYPE_BUFFER_PROPERTIES = 2, ///< ::ur_buffer_properties_t
230+ UR_STRUCTURE_TYPE_BUFFER_REGION = 3, ///< ::ur_buffer_region_t
231+ UR_STRUCTURE_TYPE_BUFFER_CHANNEL_PROPERTIES = 4, ///< ::ur_buffer_channel_properties_t
232+ UR_STRUCTURE_TYPE_BUFFER_ALLOC_LOCATION_PROPERTIES = 5, ///< ::ur_buffer_alloc_location_properties_t
233+ UR_STRUCTURE_TYPE_PROGRAM_PROPERTIES = 6, ///< ::ur_program_properties_t
234+ UR_STRUCTURE_TYPE_USM_DESC = 7, ///< ::ur_usm_desc_t
235+ UR_STRUCTURE_TYPE_USM_HOST_DESC = 8, ///< ::ur_usm_host_desc_t
236+ UR_STRUCTURE_TYPE_USM_DEVICE_DESC = 9, ///< ::ur_usm_device_desc_t
237+ UR_STRUCTURE_TYPE_USM_POOL_DESC = 10, ///< ::ur_usm_pool_desc_t
238+ UR_STRUCTURE_TYPE_USM_POOL_LIMITS_DESC = 11, ///< ::ur_usm_pool_limits_desc_t
239+ UR_STRUCTURE_TYPE_DEVICE_BINARY = 12, ///< ::ur_device_binary_t
240+ UR_STRUCTURE_TYPE_SAMPLER_DESC = 13, ///< ::ur_sampler_desc_t
241+ UR_STRUCTURE_TYPE_QUEUE_PROPERTIES = 14, ///< ::ur_queue_properties_t
242+ UR_STRUCTURE_TYPE_QUEUE_INDEX_PROPERTIES = 15, ///< ::ur_queue_index_properties_t
243+ UR_STRUCTURE_TYPE_CONTEXT_NATIVE_PROPERTIES = 16, ///< ::ur_context_native_properties_t
244+ UR_STRUCTURE_TYPE_KERNEL_NATIVE_PROPERTIES = 17, ///< ::ur_kernel_native_properties_t
245+ UR_STRUCTURE_TYPE_QUEUE_NATIVE_PROPERTIES = 18, ///< ::ur_queue_native_properties_t
246+ UR_STRUCTURE_TYPE_MEM_NATIVE_PROPERTIES = 19, ///< ::ur_mem_native_properties_t
247+ UR_STRUCTURE_TYPE_EVENT_NATIVE_PROPERTIES = 20, ///< ::ur_event_native_properties_t
248+ UR_STRUCTURE_TYPE_PLATFORM_NATIVE_PROPERTIES = 21, ///< ::ur_platform_native_properties_t
249+ UR_STRUCTURE_TYPE_DEVICE_NATIVE_PROPERTIES = 22, ///< ::ur_device_native_properties_t
250+ UR_STRUCTURE_TYPE_PROGRAM_NATIVE_PROPERTIES = 23, ///< ::ur_program_native_properties_t
251+ UR_STRUCTURE_TYPE_SAMPLER_NATIVE_PROPERTIES = 24, ///< ::ur_sampler_native_properties_t
252+ UR_STRUCTURE_TYPE_QUEUE_NATIVE_DESC = 25, ///< ::ur_queue_native_desc_t
253+ UR_STRUCTURE_TYPE_DEVICE_PARTITION_PROPERTIES = 26, ///< ::ur_device_partition_properties_t
254+ UR_STRUCTURE_TYPE_KERNEL_ARG_MEM_OBJ_PROPERTIES = 27, ///< ::ur_kernel_arg_mem_obj_properties_t
255+ UR_STRUCTURE_TYPE_PHYSICAL_MEM_PROPERTIES = 28, ///< ::ur_physical_mem_properties_t
256+ UR_STRUCTURE_TYPE_KERNEL_ARG_POINTER_PROPERTIES = 29, ///< ::ur_kernel_arg_pointer_properties_t
257+ UR_STRUCTURE_TYPE_KERNEL_ARG_SAMPLER_PROPERTIES = 30, ///< ::ur_kernel_arg_sampler_properties_t
258+ UR_STRUCTURE_TYPE_KERNEL_EXEC_INFO_PROPERTIES = 31, ///< ::ur_kernel_exec_info_properties_t
259+ UR_STRUCTURE_TYPE_KERNEL_ARG_VALUE_PROPERTIES = 32, ///< ::ur_kernel_arg_value_properties_t
260+ UR_STRUCTURE_TYPE_KERNEL_ARG_LOCAL_PROPERTIES = 33, ///< ::ur_kernel_arg_local_properties_t
261+ UR_STRUCTURE_TYPE_USM_ALLOC_LOCATION_DESC = 35 , ///< ::ur_usm_alloc_location_desc_t
262+ UR_STRUCTURE_TYPE_EXP_COMMAND_BUFFER_DESC = 0x1000 , ///< ::ur_exp_command_buffer_desc_t
263+ UR_STRUCTURE_TYPE_EXP_SAMPLER_MIP_PROPERTIES = 0x2000 , ///< ::ur_exp_sampler_mip_properties_t
264+ UR_STRUCTURE_TYPE_EXP_INTEROP_MEM_DESC = 0x2001 , ///< ::ur_exp_interop_mem_desc_t
265+ UR_STRUCTURE_TYPE_EXP_INTEROP_SEMAPHORE_DESC = 0x2002 , ///< ::ur_exp_interop_semaphore_desc_t
266+ UR_STRUCTURE_TYPE_EXP_FILE_DESCRIPTOR = 0x2003 , ///< ::ur_exp_file_descriptor_t
267+ UR_STRUCTURE_TYPE_EXP_WIN32_HANDLE = 0x2004, ///< ::ur_exp_win32_handle_t
268+ UR_STRUCTURE_TYPE_EXP_SAMPLER_ADDR_MODES = 0x2005, ///< ::ur_exp_sampler_addr_modes_t
269269 /// @cond
270270 UR_STRUCTURE_TYPE_FORCE_UINT32 = 0x7fffffff
271271 /// @endcond
@@ -3287,6 +3287,25 @@ typedef struct ur_usm_device_desc_t {
32873287
32883288} ur_usm_device_desc_t;
32893289
3290+ ///////////////////////////////////////////////////////////////////////////////
3291+ /// @brief USM allocation location desc
3292+ ///
3293+ /// @details
3294+ /// - Specify these properties in ::urUSMHostAlloc, ::urUSMDeviceAlloc and
3295+ /// ::urUSMSharedAlloc via ::ur_usm_desc_t as part of a `pNext` chain.
3296+ ///
3297+ /// @remarks
3298+ /// _Analogues_
3299+ /// - cl_intel_mem_alloc_buffer_location
3300+ typedef struct ur_usm_alloc_location_desc_t {
3301+ ur_structure_type_t stype; ///< [in] type of this structure, must be
3302+ ///< ::UR_STRUCTURE_TYPE_USM_ALLOC_LOCATION_DESC
3303+ const void *pNext; ///< [in][optional] pointer to extension-specific structure
3304+ uint32_t location; ///< [in] Identifies the ID of global memory partition to which the memory
3305+ ///< should be allocated.
3306+
3307+ } ur_usm_alloc_location_desc_t;
3308+
32903309///////////////////////////////////////////////////////////////////////////////
32913310/// @brief USM pool descriptor type
32923311typedef struct ur_usm_pool_desc_t {
@@ -3324,6 +3343,7 @@ typedef struct ur_usm_pool_limits_desc_t {
33243343/// - Any flags/hints passed through pUSMDesc only affect the single
33253344/// allocation.
33263345/// - See also ::ur_usm_host_desc_t.
3346+ /// - See also ::ur_usm_alloc_location_desc_t.
33273347///
33283348/// @returns
33293349/// - ::UR_RESULT_SUCCESS
@@ -3369,6 +3389,7 @@ urUSMHostAlloc(
33693389/// - Any flags/hints passed through pUSMDesc only affect the single
33703390/// allocation.
33713391/// - See also ::ur_usm_device_desc_t.
3392+ /// - See also ::ur_usm_alloc_location_desc_t.
33723393///
33733394/// @returns
33743395/// - ::UR_RESULT_SUCCESS
@@ -3417,6 +3438,7 @@ urUSMDeviceAlloc(
34173438/// allocation.
34183439/// - See also ::ur_usm_host_desc_t.
34193440/// - See also ::ur_usm_device_desc_t.
3441+ /// - See also ::ur_usm_alloc_location_desc_t.
34203442///
34213443/// @returns
34223444/// - ::UR_RESULT_SUCCESS
@@ -7129,21 +7151,6 @@ typedef struct ur_exp_interop_semaphore_desc_t {
71297151
71307152} ur_exp_interop_semaphore_desc_t;
71317153
7132- ///////////////////////////////////////////////////////////////////////////////
7133- /// @brief Describes layered image properties
7134- ///
7135- /// @details
7136- /// - Specify these properties in ::urBindlessImagesUnsampledImageCreateExp
7137- /// or ::urBindlessImagesSampledImageCreateExp via ::ur_image_desc_t as
7138- /// part of a `pNext` chain.
7139- typedef struct ur_exp_layered_image_properties_t {
7140- ur_structure_type_t stype; ///< [in] type of this structure, must be
7141- ///< ::UR_STRUCTURE_TYPE_EXP_LAYERED_IMAGE_PROPERTIES
7142- void *pNext; ///< [in,out][optional] pointer to extension-specific structure
7143- uint32_t numLayers; ///< [in] number of layers the image should have
7144-
7145- } ur_exp_layered_image_properties_t;
7146-
71477154///////////////////////////////////////////////////////////////////////////////
71487155/// @brief USM allocate pitched memory
71497156///
0 commit comments