1 /******************************************************************************* 2 * Copyright (c) 2008-2020 The Khronos Group Inc. 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 ******************************************************************************/ 16 17 #ifndef __OPENCL_CL_H 18 #define __OPENCL_CL_H 19 20 #include <CL/cl_version.h> 21 #include <CL/cl_platform.h> 22 23 #ifdef __cplusplus 24 extern "C" { 25 #endif 26 27 /******************************************************************************/ 28 29 typedef struct _cl_platform_id * cl_platform_id; 30 typedef struct _cl_device_id * cl_device_id; 31 typedef struct _cl_context * cl_context; 32 typedef struct _cl_command_queue * cl_command_queue; 33 typedef struct _cl_mem * cl_mem; 34 typedef struct _cl_program * cl_program; 35 typedef struct _cl_kernel * cl_kernel; 36 typedef struct _cl_event * cl_event; 37 typedef struct _cl_sampler * cl_sampler; 38 39 typedef cl_uint cl_bool; /* WARNING! Unlike cl_ types in cl_platform.h, cl_bool is not guaranteed to be the same size as the bool in kernels. */ 40 typedef cl_ulong cl_bitfield; 41 typedef cl_ulong cl_properties; 42 typedef cl_bitfield cl_device_type; 43 typedef cl_uint cl_platform_info; 44 typedef cl_uint cl_device_info; 45 typedef cl_bitfield cl_device_fp_config; 46 typedef cl_uint cl_device_mem_cache_type; 47 typedef cl_uint cl_device_local_mem_type; 48 typedef cl_bitfield cl_device_exec_capabilities; 49 #ifdef CL_VERSION_2_0 50 typedef cl_bitfield cl_device_svm_capabilities; 51 #endif 52 typedef cl_bitfield cl_command_queue_properties; 53 #ifdef CL_VERSION_1_2 54 typedef intptr_t cl_device_partition_property; 55 typedef cl_bitfield cl_device_affinity_domain; 56 #endif 57 58 typedef intptr_t cl_context_properties; 59 typedef cl_uint cl_context_info; 60 #ifdef CL_VERSION_2_0 61 typedef cl_properties cl_queue_properties; 62 #endif 63 typedef cl_uint cl_command_queue_info; 64 typedef cl_uint cl_channel_order; 65 typedef cl_uint cl_channel_type; 66 typedef cl_bitfield cl_mem_flags; 67 #ifdef CL_VERSION_2_0 68 typedef cl_bitfield cl_svm_mem_flags; 69 #endif 70 typedef cl_uint cl_mem_object_type; 71 typedef cl_uint cl_mem_info; 72 #ifdef CL_VERSION_1_2 73 typedef cl_bitfield cl_mem_migration_flags; 74 #endif 75 typedef cl_uint cl_image_info; 76 #ifdef CL_VERSION_1_1 77 typedef cl_uint cl_buffer_create_type; 78 #endif 79 typedef cl_uint cl_addressing_mode; 80 typedef cl_uint cl_filter_mode; 81 typedef cl_uint cl_sampler_info; 82 typedef cl_bitfield cl_map_flags; 83 #ifdef CL_VERSION_2_0 84 typedef intptr_t cl_pipe_properties; 85 typedef cl_uint cl_pipe_info; 86 #endif 87 typedef cl_uint cl_program_info; 88 typedef cl_uint cl_program_build_info; 89 #ifdef CL_VERSION_1_2 90 typedef cl_uint cl_program_binary_type; 91 #endif 92 typedef cl_int cl_build_status; 93 typedef cl_uint cl_kernel_info; 94 #ifdef CL_VERSION_1_2 95 typedef cl_uint cl_kernel_arg_info; 96 typedef cl_uint cl_kernel_arg_address_qualifier; 97 typedef cl_uint cl_kernel_arg_access_qualifier; 98 typedef cl_bitfield cl_kernel_arg_type_qualifier; 99 #endif 100 typedef cl_uint cl_kernel_work_group_info; 101 #ifdef CL_VERSION_2_1 102 typedef cl_uint cl_kernel_sub_group_info; 103 #endif 104 typedef cl_uint cl_event_info; 105 typedef cl_uint cl_command_type; 106 typedef cl_uint cl_profiling_info; 107 #ifdef CL_VERSION_2_0 108 typedef cl_properties cl_sampler_properties; 109 typedef cl_uint cl_kernel_exec_info; 110 #endif 111 #ifdef CL_VERSION_3_0 112 typedef cl_bitfield cl_device_atomic_capabilities; 113 typedef cl_bitfield cl_device_device_enqueue_capabilities; 114 typedef cl_uint cl_khronos_vendor_id; 115 typedef cl_properties cl_mem_properties; 116 #endif 117 typedef cl_uint cl_version; 118 119 typedef struct _cl_image_format { 120 cl_channel_order image_channel_order; 121 cl_channel_type image_channel_data_type; 122 } cl_image_format; 123 124 #ifdef CL_VERSION_1_2 125 126 typedef struct _cl_image_desc { 127 cl_mem_object_type image_type; 128 size_t image_width; 129 size_t image_height; 130 size_t image_depth; 131 size_t image_array_size; 132 size_t image_row_pitch; 133 size_t image_slice_pitch; 134 cl_uint num_mip_levels; 135 cl_uint num_samples; 136 #ifdef CL_VERSION_2_0 137 #if defined(__GNUC__) 138 __extension__ /* Prevents warnings about anonymous union in -pedantic builds */ 139 #endif 140 #if defined(_MSC_VER) && !defined(__STDC__) 141 #pragma warning( push ) 142 #pragma warning( disable : 4201 ) /* Prevents warning about nameless struct/union in /W4 builds */ 143 #endif 144 #ifdef __clang__ 145 #pragma clang diagnostic push 146 #pragma clang diagnostic ignored "-Wc11-extensions" /* Prevents warning about nameless union being C11 extension*/ 147 #endif 148 #if defined(_MSC_VER) && defined(__STDC__) 149 /* Anonymous unions are not supported in /Za builds */ 150 #else 151 union { 152 #endif 153 #endif 154 cl_mem buffer; 155 #ifdef CL_VERSION_2_0 156 #if defined(_MSC_VER) && defined(__STDC__) 157 /* Anonymous unions are not supported in /Za builds */ 158 #else 159 cl_mem mem_object; 160 }; 161 #endif 162 #if defined(_MSC_VER) && !defined(__STDC__) 163 #pragma warning( pop ) 164 #endif 165 #ifdef __clang__ 166 #pragma clang diagnostic pop 167 #endif 168 #endif 169 } cl_image_desc; 170 171 #endif 172 173 #ifdef CL_VERSION_1_1 174 175 typedef struct _cl_buffer_region { 176 size_t origin; 177 size_t size; 178 } cl_buffer_region; 179 180 #endif 181 182 #ifdef CL_VERSION_3_0 183 184 #define CL_NAME_VERSION_MAX_NAME_SIZE 64 185 186 typedef struct _cl_name_version { 187 cl_version version; 188 char name[CL_NAME_VERSION_MAX_NAME_SIZE]; 189 } cl_name_version; 190 191 #endif 192 193 /******************************************************************************/ 194 195 /* Error Codes */ 196 #define CL_SUCCESS 0 197 #define CL_DEVICE_NOT_FOUND -1 198 #define CL_DEVICE_NOT_AVAILABLE -2 199 #define CL_COMPILER_NOT_AVAILABLE -3 200 #define CL_MEM_OBJECT_ALLOCATION_FAILURE -4 201 #define CL_OUT_OF_RESOURCES -5 202 #define CL_OUT_OF_HOST_MEMORY -6 203 #define CL_PROFILING_INFO_NOT_AVAILABLE -7 204 #define CL_MEM_COPY_OVERLAP -8 205 #define CL_IMAGE_FORMAT_MISMATCH -9 206 #define CL_IMAGE_FORMAT_NOT_SUPPORTED -10 207 #define CL_BUILD_PROGRAM_FAILURE -11 208 #define CL_MAP_FAILURE -12 209 #ifdef CL_VERSION_1_1 210 #define CL_MISALIGNED_SUB_BUFFER_OFFSET -13 211 #define CL_EXEC_STATUS_ERROR_FOR_EVENTS_IN_WAIT_LIST -14 212 #endif 213 #ifdef CL_VERSION_1_2 214 #define CL_COMPILE_PROGRAM_FAILURE -15 215 #define CL_LINKER_NOT_AVAILABLE -16 216 #define CL_LINK_PROGRAM_FAILURE -17 217 #define CL_DEVICE_PARTITION_FAILED -18 218 #define CL_KERNEL_ARG_INFO_NOT_AVAILABLE -19 219 #endif 220 221 #define CL_INVALID_VALUE -30 222 #define CL_INVALID_DEVICE_TYPE -31 223 #define CL_INVALID_PLATFORM -32 224 #define CL_INVALID_DEVICE -33 225 #define CL_INVALID_CONTEXT -34 226 #define CL_INVALID_QUEUE_PROPERTIES -35 227 #define CL_INVALID_COMMAND_QUEUE -36 228 #define CL_INVALID_HOST_PTR -37 229 #define CL_INVALID_MEM_OBJECT -38 230 #define CL_INVALID_IMAGE_FORMAT_DESCRIPTOR -39 231 #define CL_INVALID_IMAGE_SIZE -40 232 #define CL_INVALID_SAMPLER -41 233 #define CL_INVALID_BINARY -42 234 #define CL_INVALID_BUILD_OPTIONS -43 235 #define CL_INVALID_PROGRAM -44 236 #define CL_INVALID_PROGRAM_EXECUTABLE -45 237 #define CL_INVALID_KERNEL_NAME -46 238 #define CL_INVALID_KERNEL_DEFINITION -47 239 #define CL_INVALID_KERNEL -48 240 #define CL_INVALID_ARG_INDEX -49 241 #define CL_INVALID_ARG_VALUE -50 242 #define CL_INVALID_ARG_SIZE -51 243 #define CL_INVALID_KERNEL_ARGS -52 244 #define CL_INVALID_WORK_DIMENSION -53 245 #define CL_INVALID_WORK_GROUP_SIZE -54 246 #define CL_INVALID_WORK_ITEM_SIZE -55 247 #define CL_INVALID_GLOBAL_OFFSET -56 248 #define CL_INVALID_EVENT_WAIT_LIST -57 249 #define CL_INVALID_EVENT -58 250 #define CL_INVALID_OPERATION -59 251 #define CL_INVALID_GL_OBJECT -60 252 #define CL_INVALID_BUFFER_SIZE -61 253 #define CL_INVALID_MIP_LEVEL -62 254 #define CL_INVALID_GLOBAL_WORK_SIZE -63 255 #ifdef CL_VERSION_1_1 256 #define CL_INVALID_PROPERTY -64 257 #endif 258 #ifdef CL_VERSION_1_2 259 #define CL_INVALID_IMAGE_DESCRIPTOR -65 260 #define CL_INVALID_COMPILER_OPTIONS -66 261 #define CL_INVALID_LINKER_OPTIONS -67 262 #define CL_INVALID_DEVICE_PARTITION_COUNT -68 263 #endif 264 #ifdef CL_VERSION_2_0 265 #define CL_INVALID_PIPE_SIZE -69 266 #define CL_INVALID_DEVICE_QUEUE -70 267 #endif 268 #ifdef CL_VERSION_2_2 269 #define CL_INVALID_SPEC_ID -71 270 #define CL_MAX_SIZE_RESTRICTION_EXCEEDED -72 271 #endif 272 273 274 /* cl_bool */ 275 #define CL_FALSE 0 276 #define CL_TRUE 1 277 #ifdef CL_VERSION_1_2 278 #define CL_BLOCKING CL_TRUE 279 #define CL_NON_BLOCKING CL_FALSE 280 #endif 281 282 /* cl_platform_info */ 283 #define CL_PLATFORM_PROFILE 0x0900 284 #define CL_PLATFORM_VERSION 0x0901 285 #define CL_PLATFORM_NAME 0x0902 286 #define CL_PLATFORM_VENDOR 0x0903 287 #define CL_PLATFORM_EXTENSIONS 0x0904 288 #ifdef CL_VERSION_2_1 289 #define CL_PLATFORM_HOST_TIMER_RESOLUTION 0x0905 290 #endif 291 #ifdef CL_VERSION_3_0 292 #define CL_PLATFORM_NUMERIC_VERSION 0x0906 293 #define CL_PLATFORM_EXTENSIONS_WITH_VERSION 0x0907 294 #endif 295 296 /* cl_device_type - bitfield */ 297 #define CL_DEVICE_TYPE_DEFAULT (1 << 0) 298 #define CL_DEVICE_TYPE_CPU (1 << 1) 299 #define CL_DEVICE_TYPE_GPU (1 << 2) 300 #define CL_DEVICE_TYPE_ACCELERATOR (1 << 3) 301 #ifdef CL_VERSION_1_2 302 #define CL_DEVICE_TYPE_CUSTOM (1 << 4) 303 #endif 304 #define CL_DEVICE_TYPE_ALL 0xFFFFFFFF 305 306 /* cl_device_info */ 307 #define CL_DEVICE_TYPE 0x1000 308 #define CL_DEVICE_VENDOR_ID 0x1001 309 #define CL_DEVICE_MAX_COMPUTE_UNITS 0x1002 310 #define CL_DEVICE_MAX_WORK_ITEM_DIMENSIONS 0x1003 311 #define CL_DEVICE_MAX_WORK_GROUP_SIZE 0x1004 312 #define CL_DEVICE_MAX_WORK_ITEM_SIZES 0x1005 313 #define CL_DEVICE_PREFERRED_VECTOR_WIDTH_CHAR 0x1006 314 #define CL_DEVICE_PREFERRED_VECTOR_WIDTH_SHORT 0x1007 315 #define CL_DEVICE_PREFERRED_VECTOR_WIDTH_INT 0x1008 316 #define CL_DEVICE_PREFERRED_VECTOR_WIDTH_LONG 0x1009 317 #define CL_DEVICE_PREFERRED_VECTOR_WIDTH_FLOAT 0x100A 318 #define CL_DEVICE_PREFERRED_VECTOR_WIDTH_DOUBLE 0x100B 319 #define CL_DEVICE_MAX_CLOCK_FREQUENCY 0x100C 320 #define CL_DEVICE_ADDRESS_BITS 0x100D 321 #define CL_DEVICE_MAX_READ_IMAGE_ARGS 0x100E 322 #define CL_DEVICE_MAX_WRITE_IMAGE_ARGS 0x100F 323 #define CL_DEVICE_MAX_MEM_ALLOC_SIZE 0x1010 324 #define CL_DEVICE_IMAGE2D_MAX_WIDTH 0x1011 325 #define CL_DEVICE_IMAGE2D_MAX_HEIGHT 0x1012 326 #define CL_DEVICE_IMAGE3D_MAX_WIDTH 0x1013 327 #define CL_DEVICE_IMAGE3D_MAX_HEIGHT 0x1014 328 #define CL_DEVICE_IMAGE3D_MAX_DEPTH 0x1015 329 #define CL_DEVICE_IMAGE_SUPPORT 0x1016 330 #define CL_DEVICE_MAX_PARAMETER_SIZE 0x1017 331 #define CL_DEVICE_MAX_SAMPLERS 0x1018 332 #define CL_DEVICE_MEM_BASE_ADDR_ALIGN 0x1019 333 #define CL_DEVICE_MIN_DATA_TYPE_ALIGN_SIZE 0x101A 334 #define CL_DEVICE_SINGLE_FP_CONFIG 0x101B 335 #define CL_DEVICE_GLOBAL_MEM_CACHE_TYPE 0x101C 336 #define CL_DEVICE_GLOBAL_MEM_CACHELINE_SIZE 0x101D 337 #define CL_DEVICE_GLOBAL_MEM_CACHE_SIZE 0x101E 338 #define CL_DEVICE_GLOBAL_MEM_SIZE 0x101F 339 #define CL_DEVICE_MAX_CONSTANT_BUFFER_SIZE 0x1020 340 #define CL_DEVICE_MAX_CONSTANT_ARGS 0x1021 341 #define CL_DEVICE_LOCAL_MEM_TYPE 0x1022 342 #define CL_DEVICE_LOCAL_MEM_SIZE 0x1023 343 #define CL_DEVICE_ERROR_CORRECTION_SUPPORT 0x1024 344 #define CL_DEVICE_PROFILING_TIMER_RESOLUTION 0x1025 345 #define CL_DEVICE_ENDIAN_LITTLE 0x1026 346 #define CL_DEVICE_AVAILABLE 0x1027 347 #define CL_DEVICE_COMPILER_AVAILABLE 0x1028 348 #define CL_DEVICE_EXECUTION_CAPABILITIES 0x1029 349 #define CL_DEVICE_QUEUE_PROPERTIES 0x102A /* deprecated */ 350 #ifdef CL_VERSION_2_0 351 #define CL_DEVICE_QUEUE_ON_HOST_PROPERTIES 0x102A 352 #endif 353 #define CL_DEVICE_NAME 0x102B 354 #define CL_DEVICE_VENDOR 0x102C 355 #define CL_DRIVER_VERSION 0x102D 356 #define CL_DEVICE_PROFILE 0x102E 357 #define CL_DEVICE_VERSION 0x102F 358 #define CL_DEVICE_EXTENSIONS 0x1030 359 #define CL_DEVICE_PLATFORM 0x1031 360 #ifdef CL_VERSION_1_2 361 #define CL_DEVICE_DOUBLE_FP_CONFIG 0x1032 362 #endif 363 /* 0x1033 reserved for CL_DEVICE_HALF_FP_CONFIG which is already defined in "cl_ext.h" */ 364 #ifdef CL_VERSION_1_1 365 #define CL_DEVICE_PREFERRED_VECTOR_WIDTH_HALF 0x1034 366 #define CL_DEVICE_HOST_UNIFIED_MEMORY 0x1035 /* deprecated */ 367 #define CL_DEVICE_NATIVE_VECTOR_WIDTH_CHAR 0x1036 368 #define CL_DEVICE_NATIVE_VECTOR_WIDTH_SHORT 0x1037 369 #define CL_DEVICE_NATIVE_VECTOR_WIDTH_INT 0x1038 370 #define CL_DEVICE_NATIVE_VECTOR_WIDTH_LONG 0x1039 371 #define CL_DEVICE_NATIVE_VECTOR_WIDTH_FLOAT 0x103A 372 #define CL_DEVICE_NATIVE_VECTOR_WIDTH_DOUBLE 0x103B 373 #define CL_DEVICE_NATIVE_VECTOR_WIDTH_HALF 0x103C 374 #define CL_DEVICE_OPENCL_C_VERSION 0x103D 375 #endif 376 #ifdef CL_VERSION_1_2 377 #define CL_DEVICE_LINKER_AVAILABLE 0x103E 378 #define CL_DEVICE_BUILT_IN_KERNELS 0x103F 379 #define CL_DEVICE_IMAGE_MAX_BUFFER_SIZE 0x1040 380 #define CL_DEVICE_IMAGE_MAX_ARRAY_SIZE 0x1041 381 #define CL_DEVICE_PARENT_DEVICE 0x1042 382 #define CL_DEVICE_PARTITION_MAX_SUB_DEVICES 0x1043 383 #define CL_DEVICE_PARTITION_PROPERTIES 0x1044 384 #define CL_DEVICE_PARTITION_AFFINITY_DOMAIN 0x1045 385 #define CL_DEVICE_PARTITION_TYPE 0x1046 386 #define CL_DEVICE_REFERENCE_COUNT 0x1047 387 #define CL_DEVICE_PREFERRED_INTEROP_USER_SYNC 0x1048 388 #define CL_DEVICE_PRINTF_BUFFER_SIZE 0x1049 389 #endif 390 #ifdef CL_VERSION_2_0 391 #define CL_DEVICE_IMAGE_PITCH_ALIGNMENT 0x104A 392 #define CL_DEVICE_IMAGE_BASE_ADDRESS_ALIGNMENT 0x104B 393 #define CL_DEVICE_MAX_READ_WRITE_IMAGE_ARGS 0x104C 394 #define CL_DEVICE_MAX_GLOBAL_VARIABLE_SIZE 0x104D 395 #define CL_DEVICE_QUEUE_ON_DEVICE_PROPERTIES 0x104E 396 #define CL_DEVICE_QUEUE_ON_DEVICE_PREFERRED_SIZE 0x104F 397 #define CL_DEVICE_QUEUE_ON_DEVICE_MAX_SIZE 0x1050 398 #define CL_DEVICE_MAX_ON_DEVICE_QUEUES 0x1051 399 #define CL_DEVICE_MAX_ON_DEVICE_EVENTS 0x1052 400 #define CL_DEVICE_SVM_CAPABILITIES 0x1053 401 #define CL_DEVICE_GLOBAL_VARIABLE_PREFERRED_TOTAL_SIZE 0x1054 402 #define CL_DEVICE_MAX_PIPE_ARGS 0x1055 403 #define CL_DEVICE_PIPE_MAX_ACTIVE_RESERVATIONS 0x1056 404 #define CL_DEVICE_PIPE_MAX_PACKET_SIZE 0x1057 405 #define CL_DEVICE_PREFERRED_PLATFORM_ATOMIC_ALIGNMENT 0x1058 406 #define CL_DEVICE_PREFERRED_GLOBAL_ATOMIC_ALIGNMENT 0x1059 407 #define CL_DEVICE_PREFERRED_LOCAL_ATOMIC_ALIGNMENT 0x105A 408 #endif 409 #ifdef CL_VERSION_2_1 410 #define CL_DEVICE_IL_VERSION 0x105B 411 #define CL_DEVICE_MAX_NUM_SUB_GROUPS 0x105C 412 #define CL_DEVICE_SUB_GROUP_INDEPENDENT_FORWARD_PROGRESS 0x105D 413 #endif 414 #ifdef CL_VERSION_3_0 415 #define CL_DEVICE_NUMERIC_VERSION 0x105E 416 #define CL_DEVICE_EXTENSIONS_WITH_VERSION 0x1060 417 #define CL_DEVICE_ILS_WITH_VERSION 0x1061 418 #define CL_DEVICE_BUILT_IN_KERNELS_WITH_VERSION 0x1062 419 #define CL_DEVICE_ATOMIC_MEMORY_CAPABILITIES 0x1063 420 #define CL_DEVICE_ATOMIC_FENCE_CAPABILITIES 0x1064 421 #define CL_DEVICE_NON_UNIFORM_WORK_GROUP_SUPPORT 0x1065 422 #define CL_DEVICE_OPENCL_C_ALL_VERSIONS 0x1066 423 #define CL_DEVICE_PREFERRED_WORK_GROUP_SIZE_MULTIPLE 0x1067 424 #define CL_DEVICE_WORK_GROUP_COLLECTIVE_FUNCTIONS_SUPPORT 0x1068 425 #define CL_DEVICE_GENERIC_ADDRESS_SPACE_SUPPORT 0x1069 426 /* 0x106A to 0x106E - Reserved for upcoming KHR extension */ 427 #define CL_DEVICE_OPENCL_C_FEATURES 0x106F 428 #define CL_DEVICE_DEVICE_ENQUEUE_CAPABILITIES 0x1070 429 #define CL_DEVICE_PIPE_SUPPORT 0x1071 430 #define CL_DEVICE_LATEST_CONFORMANCE_VERSION_PASSED 0x1072 431 #endif 432 433 /* cl_device_fp_config - bitfield */ 434 #define CL_FP_DENORM (1 << 0) 435 #define CL_FP_INF_NAN (1 << 1) 436 #define CL_FP_ROUND_TO_NEAREST (1 << 2) 437 #define CL_FP_ROUND_TO_ZERO (1 << 3) 438 #define CL_FP_ROUND_TO_INF (1 << 4) 439 #define CL_FP_FMA (1 << 5) 440 #ifdef CL_VERSION_1_1 441 #define CL_FP_SOFT_FLOAT (1 << 6) 442 #endif 443 #ifdef CL_VERSION_1_2 444 #define CL_FP_CORRECTLY_ROUNDED_DIVIDE_SQRT (1 << 7) 445 #endif 446 447 /* cl_device_mem_cache_type */ 448 #define CL_NONE 0x0 449 #define CL_READ_ONLY_CACHE 0x1 450 #define CL_READ_WRITE_CACHE 0x2 451 452 /* cl_device_local_mem_type */ 453 #define CL_LOCAL 0x1 454 #define CL_GLOBAL 0x2 455 456 /* cl_device_exec_capabilities - bitfield */ 457 #define CL_EXEC_KERNEL (1 << 0) 458 #define CL_EXEC_NATIVE_KERNEL (1 << 1) 459 460 /* cl_command_queue_properties - bitfield */ 461 #define CL_QUEUE_OUT_OF_ORDER_EXEC_MODE_ENABLE (1 << 0) 462 #define CL_QUEUE_PROFILING_ENABLE (1 << 1) 463 #ifdef CL_VERSION_2_0 464 #define CL_QUEUE_ON_DEVICE (1 << 2) 465 #define CL_QUEUE_ON_DEVICE_DEFAULT (1 << 3) 466 #endif 467 468 /* cl_context_info */ 469 #define CL_CONTEXT_REFERENCE_COUNT 0x1080 470 #define CL_CONTEXT_DEVICES 0x1081 471 #define CL_CONTEXT_PROPERTIES 0x1082 472 #ifdef CL_VERSION_1_1 473 #define CL_CONTEXT_NUM_DEVICES 0x1083 474 #endif 475 476 /* cl_context_properties */ 477 #define CL_CONTEXT_PLATFORM 0x1084 478 #ifdef CL_VERSION_1_2 479 #define CL_CONTEXT_INTEROP_USER_SYNC 0x1085 480 #endif 481 482 #ifdef CL_VERSION_1_2 483 484 /* cl_device_partition_property */ 485 #define CL_DEVICE_PARTITION_EQUALLY 0x1086 486 #define CL_DEVICE_PARTITION_BY_COUNTS 0x1087 487 #define CL_DEVICE_PARTITION_BY_COUNTS_LIST_END 0x0 488 #define CL_DEVICE_PARTITION_BY_AFFINITY_DOMAIN 0x1088 489 490 #endif 491 492 #ifdef CL_VERSION_1_2 493 494 /* cl_device_affinity_domain */ 495 #define CL_DEVICE_AFFINITY_DOMAIN_NUMA (1 << 0) 496 #define CL_DEVICE_AFFINITY_DOMAIN_L4_CACHE (1 << 1) 497 #define CL_DEVICE_AFFINITY_DOMAIN_L3_CACHE (1 << 2) 498 #define CL_DEVICE_AFFINITY_DOMAIN_L2_CACHE (1 << 3) 499 #define CL_DEVICE_AFFINITY_DOMAIN_L1_CACHE (1 << 4) 500 #define CL_DEVICE_AFFINITY_DOMAIN_NEXT_PARTITIONABLE (1 << 5) 501 502 #endif 503 504 #ifdef CL_VERSION_2_0 505 506 /* cl_device_svm_capabilities */ 507 #define CL_DEVICE_SVM_COARSE_GRAIN_BUFFER (1 << 0) 508 #define CL_DEVICE_SVM_FINE_GRAIN_BUFFER (1 << 1) 509 #define CL_DEVICE_SVM_FINE_GRAIN_SYSTEM (1 << 2) 510 #define CL_DEVICE_SVM_ATOMICS (1 << 3) 511 512 #endif 513 514 /* cl_command_queue_info */ 515 #define CL_QUEUE_CONTEXT 0x1090 516 #define CL_QUEUE_DEVICE 0x1091 517 #define CL_QUEUE_REFERENCE_COUNT 0x1092 518 #define CL_QUEUE_PROPERTIES 0x1093 519 #ifdef CL_VERSION_2_0 520 #define CL_QUEUE_SIZE 0x1094 521 #endif 522 #ifdef CL_VERSION_2_1 523 #define CL_QUEUE_DEVICE_DEFAULT 0x1095 524 #endif 525 #ifdef CL_VERSION_3_0 526 #define CL_QUEUE_PROPERTIES_ARRAY 0x1098 527 #endif 528 529 /* cl_mem_flags and cl_svm_mem_flags - bitfield */ 530 #define CL_MEM_READ_WRITE (1 << 0) 531 #define CL_MEM_WRITE_ONLY (1 << 1) 532 #define CL_MEM_READ_ONLY (1 << 2) 533 #define CL_MEM_USE_HOST_PTR (1 << 3) 534 #define CL_MEM_ALLOC_HOST_PTR (1 << 4) 535 #define CL_MEM_COPY_HOST_PTR (1 << 5) 536 /* reserved (1 << 6) */ 537 #ifdef CL_VERSION_1_2 538 #define CL_MEM_HOST_WRITE_ONLY (1 << 7) 539 #define CL_MEM_HOST_READ_ONLY (1 << 8) 540 #define CL_MEM_HOST_NO_ACCESS (1 << 9) 541 #endif 542 #ifdef CL_VERSION_2_0 543 #define CL_MEM_SVM_FINE_GRAIN_BUFFER (1 << 10) /* used by cl_svm_mem_flags only */ 544 #define CL_MEM_SVM_ATOMICS (1 << 11) /* used by cl_svm_mem_flags only */ 545 #define CL_MEM_KERNEL_READ_AND_WRITE (1 << 12) 546 #endif 547 548 #ifdef CL_VERSION_1_2 549 550 /* cl_mem_migration_flags - bitfield */ 551 #define CL_MIGRATE_MEM_OBJECT_HOST (1 << 0) 552 #define CL_MIGRATE_MEM_OBJECT_CONTENT_UNDEFINED (1 << 1) 553 554 #endif 555 556 /* cl_channel_order */ 557 #define CL_R 0x10B0 558 #define CL_A 0x10B1 559 #define CL_RG 0x10B2 560 #define CL_RA 0x10B3 561 #define CL_RGB 0x10B4 562 #define CL_RGBA 0x10B5 563 #define CL_BGRA 0x10B6 564 #define CL_ARGB 0x10B7 565 #define CL_INTENSITY 0x10B8 566 #define CL_LUMINANCE 0x10B9 567 #ifdef CL_VERSION_1_1 568 #define CL_Rx 0x10BA 569 #define CL_RGx 0x10BB 570 #define CL_RGBx 0x10BC 571 #endif 572 #ifdef CL_VERSION_2_0 573 #define CL_DEPTH 0x10BD 574 #define CL_sRGB 0x10BF 575 #define CL_sRGBx 0x10C0 576 #define CL_sRGBA 0x10C1 577 #define CL_sBGRA 0x10C2 578 #define CL_ABGR 0x10C3 579 #endif 580 581 /* cl_channel_type */ 582 #define CL_SNORM_INT8 0x10D0 583 #define CL_SNORM_INT16 0x10D1 584 #define CL_UNORM_INT8 0x10D2 585 #define CL_UNORM_INT16 0x10D3 586 #define CL_UNORM_SHORT_565 0x10D4 587 #define CL_UNORM_SHORT_555 0x10D5 588 #define CL_UNORM_INT_101010 0x10D6 589 #define CL_SIGNED_INT8 0x10D7 590 #define CL_SIGNED_INT16 0x10D8 591 #define CL_SIGNED_INT32 0x10D9 592 #define CL_UNSIGNED_INT8 0x10DA 593 #define CL_UNSIGNED_INT16 0x10DB 594 #define CL_UNSIGNED_INT32 0x10DC 595 #define CL_HALF_FLOAT 0x10DD 596 #define CL_FLOAT 0x10DE 597 #ifdef CL_VERSION_2_1 598 #define CL_UNORM_INT_101010_2 0x10E0 599 #endif 600 601 /* cl_mem_object_type */ 602 #define CL_MEM_OBJECT_BUFFER 0x10F0 603 #define CL_MEM_OBJECT_IMAGE2D 0x10F1 604 #define CL_MEM_OBJECT_IMAGE3D 0x10F2 605 #ifdef CL_VERSION_1_2 606 #define CL_MEM_OBJECT_IMAGE2D_ARRAY 0x10F3 607 #define CL_MEM_OBJECT_IMAGE1D 0x10F4 608 #define CL_MEM_OBJECT_IMAGE1D_ARRAY 0x10F5 609 #define CL_MEM_OBJECT_IMAGE1D_BUFFER 0x10F6 610 #endif 611 #ifdef CL_VERSION_2_0 612 #define CL_MEM_OBJECT_PIPE 0x10F7 613 #endif 614 615 /* cl_mem_info */ 616 #define CL_MEM_TYPE 0x1100 617 #define CL_MEM_FLAGS 0x1101 618 #define CL_MEM_SIZE 0x1102 619 #define CL_MEM_HOST_PTR 0x1103 620 #define CL_MEM_MAP_COUNT 0x1104 621 #define CL_MEM_REFERENCE_COUNT 0x1105 622 #define CL_MEM_CONTEXT 0x1106 623 #ifdef CL_VERSION_1_1 624 #define CL_MEM_ASSOCIATED_MEMOBJECT 0x1107 625 #define CL_MEM_OFFSET 0x1108 626 #endif 627 #ifdef CL_VERSION_2_0 628 #define CL_MEM_USES_SVM_POINTER 0x1109 629 #endif 630 #ifdef CL_VERSION_3_0 631 #define CL_MEM_PROPERTIES 0x110A 632 #endif 633 634 /* cl_image_info */ 635 #define CL_IMAGE_FORMAT 0x1110 636 #define CL_IMAGE_ELEMENT_SIZE 0x1111 637 #define CL_IMAGE_ROW_PITCH 0x1112 638 #define CL_IMAGE_SLICE_PITCH 0x1113 639 #define CL_IMAGE_WIDTH 0x1114 640 #define CL_IMAGE_HEIGHT 0x1115 641 #define CL_IMAGE_DEPTH 0x1116 642 #ifdef CL_VERSION_1_2 643 #define CL_IMAGE_ARRAY_SIZE 0x1117 644 #define CL_IMAGE_BUFFER 0x1118 645 #define CL_IMAGE_NUM_MIP_LEVELS 0x1119 646 #define CL_IMAGE_NUM_SAMPLES 0x111A 647 #endif 648 649 650 /* cl_pipe_info */ 651 #ifdef CL_VERSION_2_0 652 #define CL_PIPE_PACKET_SIZE 0x1120 653 #define CL_PIPE_MAX_PACKETS 0x1121 654 #endif 655 #ifdef CL_VERSION_3_0 656 #define CL_PIPE_PROPERTIES 0x1122 657 #endif 658 659 /* cl_addressing_mode */ 660 #define CL_ADDRESS_NONE 0x1130 661 #define CL_ADDRESS_CLAMP_TO_EDGE 0x1131 662 #define CL_ADDRESS_CLAMP 0x1132 663 #define CL_ADDRESS_REPEAT 0x1133 664 #ifdef CL_VERSION_1_1 665 #define CL_ADDRESS_MIRRORED_REPEAT 0x1134 666 #endif 667 668 /* cl_filter_mode */ 669 #define CL_FILTER_NEAREST 0x1140 670 #define CL_FILTER_LINEAR 0x1141 671 672 /* cl_sampler_info */ 673 #define CL_SAMPLER_REFERENCE_COUNT 0x1150 674 #define CL_SAMPLER_CONTEXT 0x1151 675 #define CL_SAMPLER_NORMALIZED_COORDS 0x1152 676 #define CL_SAMPLER_ADDRESSING_MODE 0x1153 677 #define CL_SAMPLER_FILTER_MODE 0x1154 678 #ifdef CL_VERSION_2_0 679 /* These enumerants are for the cl_khr_mipmap_image extension. 680 They have since been added to cl_ext.h with an appropriate 681 KHR suffix, but are left here for backwards compatibility. */ 682 #define CL_SAMPLER_MIP_FILTER_MODE 0x1155 683 #define CL_SAMPLER_LOD_MIN 0x1156 684 #define CL_SAMPLER_LOD_MAX 0x1157 685 #endif 686 #ifdef CL_VERSION_3_0 687 #define CL_SAMPLER_PROPERTIES 0x1158 688 #endif 689 690 /* cl_map_flags - bitfield */ 691 #define CL_MAP_READ (1 << 0) 692 #define CL_MAP_WRITE (1 << 1) 693 #ifdef CL_VERSION_1_2 694 #define CL_MAP_WRITE_INVALIDATE_REGION (1 << 2) 695 #endif 696 697 /* cl_program_info */ 698 #define CL_PROGRAM_REFERENCE_COUNT 0x1160 699 #define CL_PROGRAM_CONTEXT 0x1161 700 #define CL_PROGRAM_NUM_DEVICES 0x1162 701 #define CL_PROGRAM_DEVICES 0x1163 702 #define CL_PROGRAM_SOURCE 0x1164 703 #define CL_PROGRAM_BINARY_SIZES 0x1165 704 #define CL_PROGRAM_BINARIES 0x1166 705 #ifdef CL_VERSION_1_2 706 #define CL_PROGRAM_NUM_KERNELS 0x1167 707 #define CL_PROGRAM_KERNEL_NAMES 0x1168 708 #endif 709 #ifdef CL_VERSION_2_1 710 #define CL_PROGRAM_IL 0x1169 711 #endif 712 #ifdef CL_VERSION_2_2 713 #define CL_PROGRAM_SCOPE_GLOBAL_CTORS_PRESENT 0x116A 714 #define CL_PROGRAM_SCOPE_GLOBAL_DTORS_PRESENT 0x116B 715 #endif 716 717 /* cl_program_build_info */ 718 #define CL_PROGRAM_BUILD_STATUS 0x1181 719 #define CL_PROGRAM_BUILD_OPTIONS 0x1182 720 #define CL_PROGRAM_BUILD_LOG 0x1183 721 #ifdef CL_VERSION_1_2 722 #define CL_PROGRAM_BINARY_TYPE 0x1184 723 #endif 724 #ifdef CL_VERSION_2_0 725 #define CL_PROGRAM_BUILD_GLOBAL_VARIABLE_TOTAL_SIZE 0x1185 726 #endif 727 728 #ifdef CL_VERSION_1_2 729 730 /* cl_program_binary_type */ 731 #define CL_PROGRAM_BINARY_TYPE_NONE 0x0 732 #define CL_PROGRAM_BINARY_TYPE_COMPILED_OBJECT 0x1 733 #define CL_PROGRAM_BINARY_TYPE_LIBRARY 0x2 734 #define CL_PROGRAM_BINARY_TYPE_EXECUTABLE 0x4 735 736 #endif 737 738 /* cl_build_status */ 739 #define CL_BUILD_SUCCESS 0 740 #define CL_BUILD_NONE -1 741 #define CL_BUILD_ERROR -2 742 #define CL_BUILD_IN_PROGRESS -3 743 744 /* cl_kernel_info */ 745 #define CL_KERNEL_FUNCTION_NAME 0x1190 746 #define CL_KERNEL_NUM_ARGS 0x1191 747 #define CL_KERNEL_REFERENCE_COUNT 0x1192 748 #define CL_KERNEL_CONTEXT 0x1193 749 #define CL_KERNEL_PROGRAM 0x1194 750 #ifdef CL_VERSION_1_2 751 #define CL_KERNEL_ATTRIBUTES 0x1195 752 #endif 753 754 #ifdef CL_VERSION_1_2 755 756 /* cl_kernel_arg_info */ 757 #define CL_KERNEL_ARG_ADDRESS_QUALIFIER 0x1196 758 #define CL_KERNEL_ARG_ACCESS_QUALIFIER 0x1197 759 #define CL_KERNEL_ARG_TYPE_NAME 0x1198 760 #define CL_KERNEL_ARG_TYPE_QUALIFIER 0x1199 761 #define CL_KERNEL_ARG_NAME 0x119A 762 763 #endif 764 765 #ifdef CL_VERSION_1_2 766 767 /* cl_kernel_arg_address_qualifier */ 768 #define CL_KERNEL_ARG_ADDRESS_GLOBAL 0x119B 769 #define CL_KERNEL_ARG_ADDRESS_LOCAL 0x119C 770 #define CL_KERNEL_ARG_ADDRESS_CONSTANT 0x119D 771 #define CL_KERNEL_ARG_ADDRESS_PRIVATE 0x119E 772 773 #endif 774 775 #ifdef CL_VERSION_1_2 776 777 /* cl_kernel_arg_access_qualifier */ 778 #define CL_KERNEL_ARG_ACCESS_READ_ONLY 0x11A0 779 #define CL_KERNEL_ARG_ACCESS_WRITE_ONLY 0x11A1 780 #define CL_KERNEL_ARG_ACCESS_READ_WRITE 0x11A2 781 #define CL_KERNEL_ARG_ACCESS_NONE 0x11A3 782 783 #endif 784 785 #ifdef CL_VERSION_1_2 786 787 /* cl_kernel_arg_type_qualifier */ 788 #define CL_KERNEL_ARG_TYPE_NONE 0 789 #define CL_KERNEL_ARG_TYPE_CONST (1 << 0) 790 #define CL_KERNEL_ARG_TYPE_RESTRICT (1 << 1) 791 #define CL_KERNEL_ARG_TYPE_VOLATILE (1 << 2) 792 #ifdef CL_VERSION_2_0 793 #define CL_KERNEL_ARG_TYPE_PIPE (1 << 3) 794 #endif 795 796 #endif 797 798 /* cl_kernel_work_group_info */ 799 #define CL_KERNEL_WORK_GROUP_SIZE 0x11B0 800 #define CL_KERNEL_COMPILE_WORK_GROUP_SIZE 0x11B1 801 #define CL_KERNEL_LOCAL_MEM_SIZE 0x11B2 802 #define CL_KERNEL_PREFERRED_WORK_GROUP_SIZE_MULTIPLE 0x11B3 803 #define CL_KERNEL_PRIVATE_MEM_SIZE 0x11B4 804 #ifdef CL_VERSION_1_2 805 #define CL_KERNEL_GLOBAL_WORK_SIZE 0x11B5 806 #endif 807 808 #ifdef CL_VERSION_2_1 809 810 /* cl_kernel_sub_group_info */ 811 #define CL_KERNEL_MAX_SUB_GROUP_SIZE_FOR_NDRANGE 0x2033 812 #define CL_KERNEL_SUB_GROUP_COUNT_FOR_NDRANGE 0x2034 813 #define CL_KERNEL_LOCAL_SIZE_FOR_SUB_GROUP_COUNT 0x11B8 814 #define CL_KERNEL_MAX_NUM_SUB_GROUPS 0x11B9 815 #define CL_KERNEL_COMPILE_NUM_SUB_GROUPS 0x11BA 816 817 #endif 818 819 #ifdef CL_VERSION_2_0 820 821 /* cl_kernel_exec_info */ 822 #define CL_KERNEL_EXEC_INFO_SVM_PTRS 0x11B6 823 #define CL_KERNEL_EXEC_INFO_SVM_FINE_GRAIN_SYSTEM 0x11B7 824 825 #endif 826 827 /* cl_event_info */ 828 #define CL_EVENT_COMMAND_QUEUE 0x11D0 829 #define CL_EVENT_COMMAND_TYPE 0x11D1 830 #define CL_EVENT_REFERENCE_COUNT 0x11D2 831 #define CL_EVENT_COMMAND_EXECUTION_STATUS 0x11D3 832 #ifdef CL_VERSION_1_1 833 #define CL_EVENT_CONTEXT 0x11D4 834 #endif 835 836 /* cl_command_type */ 837 #define CL_COMMAND_NDRANGE_KERNEL 0x11F0 838 #define CL_COMMAND_TASK 0x11F1 839 #define CL_COMMAND_NATIVE_KERNEL 0x11F2 840 #define CL_COMMAND_READ_BUFFER 0x11F3 841 #define CL_COMMAND_WRITE_BUFFER 0x11F4 842 #define CL_COMMAND_COPY_BUFFER 0x11F5 843 #define CL_COMMAND_READ_IMAGE 0x11F6 844 #define CL_COMMAND_WRITE_IMAGE 0x11F7 845 #define CL_COMMAND_COPY_IMAGE 0x11F8 846 #define CL_COMMAND_COPY_IMAGE_TO_BUFFER 0x11F9 847 #define CL_COMMAND_COPY_BUFFER_TO_IMAGE 0x11FA 848 #define CL_COMMAND_MAP_BUFFER 0x11FB 849 #define CL_COMMAND_MAP_IMAGE 0x11FC 850 #define CL_COMMAND_UNMAP_MEM_OBJECT 0x11FD 851 #define CL_COMMAND_MARKER 0x11FE 852 #define CL_COMMAND_ACQUIRE_GL_OBJECTS 0x11FF 853 #define CL_COMMAND_RELEASE_GL_OBJECTS 0x1200 854 #ifdef CL_VERSION_1_1 855 #define CL_COMMAND_READ_BUFFER_RECT 0x1201 856 #define CL_COMMAND_WRITE_BUFFER_RECT 0x1202 857 #define CL_COMMAND_COPY_BUFFER_RECT 0x1203 858 #define CL_COMMAND_USER 0x1204 859 #endif 860 #ifdef CL_VERSION_1_2 861 #define CL_COMMAND_BARRIER 0x1205 862 #define CL_COMMAND_MIGRATE_MEM_OBJECTS 0x1206 863 #define CL_COMMAND_FILL_BUFFER 0x1207 864 #define CL_COMMAND_FILL_IMAGE 0x1208 865 #endif 866 #ifdef CL_VERSION_2_0 867 #define CL_COMMAND_SVM_FREE 0x1209 868 #define CL_COMMAND_SVM_MEMCPY 0x120A 869 #define CL_COMMAND_SVM_MEMFILL 0x120B 870 #define CL_COMMAND_SVM_MAP 0x120C 871 #define CL_COMMAND_SVM_UNMAP 0x120D 872 #endif 873 #ifdef CL_VERSION_3_0 874 #define CL_COMMAND_SVM_MIGRATE_MEM 0x120E 875 #endif 876 877 /* command execution status */ 878 #define CL_COMPLETE 0x0 879 #define CL_RUNNING 0x1 880 #define CL_SUBMITTED 0x2 881 #define CL_QUEUED 0x3 882 883 /* cl_buffer_create_type */ 884 #ifdef CL_VERSION_1_1 885 #define CL_BUFFER_CREATE_TYPE_REGION 0x1220 886 #endif 887 888 /* cl_profiling_info */ 889 #define CL_PROFILING_COMMAND_QUEUED 0x1280 890 #define CL_PROFILING_COMMAND_SUBMIT 0x1281 891 #define CL_PROFILING_COMMAND_START 0x1282 892 #define CL_PROFILING_COMMAND_END 0x1283 893 #ifdef CL_VERSION_2_0 894 #define CL_PROFILING_COMMAND_COMPLETE 0x1284 895 #endif 896 897 /* cl_device_atomic_capabilities - bitfield */ 898 #ifdef CL_VERSION_3_0 899 #define CL_DEVICE_ATOMIC_ORDER_RELAXED (1 << 0) 900 #define CL_DEVICE_ATOMIC_ORDER_ACQ_REL (1 << 1) 901 #define CL_DEVICE_ATOMIC_ORDER_SEQ_CST (1 << 2) 902 #define CL_DEVICE_ATOMIC_SCOPE_WORK_ITEM (1 << 3) 903 #define CL_DEVICE_ATOMIC_SCOPE_WORK_GROUP (1 << 4) 904 #define CL_DEVICE_ATOMIC_SCOPE_DEVICE (1 << 5) 905 #define CL_DEVICE_ATOMIC_SCOPE_ALL_DEVICES (1 << 6) 906 #endif 907 908 /* cl_device_device_enqueue_capabilities - bitfield */ 909 #ifdef CL_VERSION_3_0 910 #define CL_DEVICE_QUEUE_SUPPORTED (1 << 0) 911 #define CL_DEVICE_QUEUE_REPLACEABLE_DEFAULT (1 << 1) 912 #endif 913 914 /* cl_khronos_vendor_id */ 915 #define CL_KHRONOS_VENDOR_ID_CODEPLAY 0x10004 916 917 /* cl_version */ 918 #define CL_VERSION_MAJOR_BITS (10) 919 #define CL_VERSION_MINOR_BITS (10) 920 #define CL_VERSION_PATCH_BITS (12) 921 922 #define CL_VERSION_MAJOR_MASK ((1 << CL_VERSION_MAJOR_BITS) - 1) 923 #define CL_VERSION_MINOR_MASK ((1 << CL_VERSION_MINOR_BITS) - 1) 924 #define CL_VERSION_PATCH_MASK ((1 << CL_VERSION_PATCH_BITS) - 1) 925 926 #define CL_VERSION_MAJOR(version) \ 927 ((version) >> (CL_VERSION_MINOR_BITS + CL_VERSION_PATCH_BITS)) 928 929 #define CL_VERSION_MINOR(version) \ 930 (((version) >> CL_VERSION_PATCH_BITS) & CL_VERSION_MINOR_MASK) 931 932 #define CL_VERSION_PATCH(version) ((version) & CL_VERSION_PATCH_MASK) 933 934 #define CL_MAKE_VERSION(major, minor, patch) \ 935 ((((major) & CL_VERSION_MAJOR_MASK) \ 936 << (CL_VERSION_MINOR_BITS + CL_VERSION_PATCH_BITS)) | \ 937 (((minor) & CL_VERSION_MINOR_MASK) << CL_VERSION_PATCH_BITS) | \ 938 ((patch) & CL_VERSION_PATCH_MASK)) 939 940 /********************************************************************************************************/ 941 942 /* CL_NO_PROTOTYPES implies CL_NO_CORE_PROTOTYPES: */ 943 #if defined(CL_NO_PROTOTYPES) && !defined(CL_NO_CORE_PROTOTYPES) 944 #define CL_NO_CORE_PROTOTYPES 945 #endif 946 947 #if !defined(CL_NO_CORE_PROTOTYPES) 948 949 /* Platform API */ 950 extern CL_API_ENTRY cl_int CL_API_CALL 951 clGetPlatformIDs(cl_uint num_entries, 952 cl_platform_id * platforms, 953 cl_uint * num_platforms) CL_API_SUFFIX__VERSION_1_0; 954 955 extern CL_API_ENTRY cl_int CL_API_CALL 956 clGetPlatformInfo(cl_platform_id platform, 957 cl_platform_info param_name, 958 size_t param_value_size, 959 void * param_value, 960 size_t * param_value_size_ret) CL_API_SUFFIX__VERSION_1_0; 961 962 /* Device APIs */ 963 extern CL_API_ENTRY cl_int CL_API_CALL 964 clGetDeviceIDs(cl_platform_id platform, 965 cl_device_type device_type, 966 cl_uint num_entries, 967 cl_device_id * devices, 968 cl_uint * num_devices) CL_API_SUFFIX__VERSION_1_0; 969 970 extern CL_API_ENTRY cl_int CL_API_CALL 971 clGetDeviceInfo(cl_device_id device, 972 cl_device_info param_name, 973 size_t param_value_size, 974 void * param_value, 975 size_t * param_value_size_ret) CL_API_SUFFIX__VERSION_1_0; 976 977 #ifdef CL_VERSION_1_2 978 979 extern CL_API_ENTRY cl_int CL_API_CALL 980 clCreateSubDevices(cl_device_id in_device, 981 const cl_device_partition_property * properties, 982 cl_uint num_devices, 983 cl_device_id * out_devices, 984 cl_uint * num_devices_ret) CL_API_SUFFIX__VERSION_1_2; 985 986 extern CL_API_ENTRY cl_int CL_API_CALL 987 clRetainDevice(cl_device_id device) CL_API_SUFFIX__VERSION_1_2; 988 989 extern CL_API_ENTRY cl_int CL_API_CALL 990 clReleaseDevice(cl_device_id device) CL_API_SUFFIX__VERSION_1_2; 991 992 #endif 993 994 #ifdef CL_VERSION_2_1 995 996 extern CL_API_ENTRY cl_int CL_API_CALL 997 clSetDefaultDeviceCommandQueue(cl_context context, 998 cl_device_id device, 999 cl_command_queue command_queue) CL_API_SUFFIX__VERSION_2_1; 1000 1001 extern CL_API_ENTRY cl_int CL_API_CALL 1002 clGetDeviceAndHostTimer(cl_device_id device, 1003 cl_ulong* device_timestamp, 1004 cl_ulong* host_timestamp) CL_API_SUFFIX__VERSION_2_1; 1005 1006 extern CL_API_ENTRY cl_int CL_API_CALL 1007 clGetHostTimer(cl_device_id device, 1008 cl_ulong * host_timestamp) CL_API_SUFFIX__VERSION_2_1; 1009 1010 #endif 1011 1012 /* Context APIs */ 1013 extern CL_API_ENTRY cl_context CL_API_CALL 1014 clCreateContext(const cl_context_properties * properties, 1015 cl_uint num_devices, 1016 const cl_device_id * devices, 1017 void (CL_CALLBACK * pfn_notify)(const char * errinfo, 1018 const void * private_info, 1019 size_t cb, 1020 void * user_data), 1021 void * user_data, 1022 cl_int * errcode_ret) CL_API_SUFFIX__VERSION_1_0; 1023 1024 extern CL_API_ENTRY cl_context CL_API_CALL 1025 clCreateContextFromType(const cl_context_properties * properties, 1026 cl_device_type device_type, 1027 void (CL_CALLBACK * pfn_notify)(const char * errinfo, 1028 const void * private_info, 1029 size_t cb, 1030 void * user_data), 1031 void * user_data, 1032 cl_int * errcode_ret) CL_API_SUFFIX__VERSION_1_0; 1033 1034 extern CL_API_ENTRY cl_int CL_API_CALL 1035 clRetainContext(cl_context context) CL_API_SUFFIX__VERSION_1_0; 1036 1037 extern CL_API_ENTRY cl_int CL_API_CALL 1038 clReleaseContext(cl_context context) CL_API_SUFFIX__VERSION_1_0; 1039 1040 extern CL_API_ENTRY cl_int CL_API_CALL 1041 clGetContextInfo(cl_context context, 1042 cl_context_info param_name, 1043 size_t param_value_size, 1044 void * param_value, 1045 size_t * param_value_size_ret) CL_API_SUFFIX__VERSION_1_0; 1046 1047 #ifdef CL_VERSION_3_0 1048 1049 extern CL_API_ENTRY cl_int CL_API_CALL 1050 clSetContextDestructorCallback(cl_context context, 1051 void (CL_CALLBACK* pfn_notify)(cl_context context, 1052 void* user_data), 1053 void* user_data) CL_API_SUFFIX__VERSION_3_0; 1054 1055 #endif 1056 1057 /* Command Queue APIs */ 1058 1059 #ifdef CL_VERSION_2_0 1060 1061 extern CL_API_ENTRY cl_command_queue CL_API_CALL 1062 clCreateCommandQueueWithProperties(cl_context context, 1063 cl_device_id device, 1064 const cl_queue_properties * properties, 1065 cl_int * errcode_ret) CL_API_SUFFIX__VERSION_2_0; 1066 1067 #endif 1068 1069 extern CL_API_ENTRY cl_int CL_API_CALL 1070 clRetainCommandQueue(cl_command_queue command_queue) CL_API_SUFFIX__VERSION_1_0; 1071 1072 extern CL_API_ENTRY cl_int CL_API_CALL 1073 clReleaseCommandQueue(cl_command_queue command_queue) CL_API_SUFFIX__VERSION_1_0; 1074 1075 extern CL_API_ENTRY cl_int CL_API_CALL 1076 clGetCommandQueueInfo(cl_command_queue command_queue, 1077 cl_command_queue_info param_name, 1078 size_t param_value_size, 1079 void * param_value, 1080 size_t * param_value_size_ret) CL_API_SUFFIX__VERSION_1_0; 1081 1082 /* Memory Object APIs */ 1083 extern CL_API_ENTRY cl_mem CL_API_CALL 1084 clCreateBuffer(cl_context context, 1085 cl_mem_flags flags, 1086 size_t size, 1087 void * host_ptr, 1088 cl_int * errcode_ret) CL_API_SUFFIX__VERSION_1_0; 1089 1090 #ifdef CL_VERSION_1_1 1091 1092 extern CL_API_ENTRY cl_mem CL_API_CALL 1093 clCreateSubBuffer(cl_mem buffer, 1094 cl_mem_flags flags, 1095 cl_buffer_create_type buffer_create_type, 1096 const void * buffer_create_info, 1097 cl_int * errcode_ret) CL_API_SUFFIX__VERSION_1_1; 1098 1099 #endif 1100 1101 #ifdef CL_VERSION_1_2 1102 1103 extern CL_API_ENTRY cl_mem CL_API_CALL 1104 clCreateImage(cl_context context, 1105 cl_mem_flags flags, 1106 const cl_image_format * image_format, 1107 const cl_image_desc * image_desc, 1108 void * host_ptr, 1109 cl_int * errcode_ret) CL_API_SUFFIX__VERSION_1_2; 1110 1111 #endif 1112 1113 #ifdef CL_VERSION_2_0 1114 1115 extern CL_API_ENTRY cl_mem CL_API_CALL 1116 clCreatePipe(cl_context context, 1117 cl_mem_flags flags, 1118 cl_uint pipe_packet_size, 1119 cl_uint pipe_max_packets, 1120 const cl_pipe_properties * properties, 1121 cl_int * errcode_ret) CL_API_SUFFIX__VERSION_2_0; 1122 1123 #endif 1124 1125 #ifdef CL_VERSION_3_0 1126 1127 extern CL_API_ENTRY cl_mem CL_API_CALL 1128 clCreateBufferWithProperties(cl_context context, 1129 const cl_mem_properties * properties, 1130 cl_mem_flags flags, 1131 size_t size, 1132 void * host_ptr, 1133 cl_int * errcode_ret) CL_API_SUFFIX__VERSION_3_0; 1134 1135 extern CL_API_ENTRY cl_mem CL_API_CALL 1136 clCreateImageWithProperties(cl_context context, 1137 const cl_mem_properties * properties, 1138 cl_mem_flags flags, 1139 const cl_image_format * image_format, 1140 const cl_image_desc * image_desc, 1141 void * host_ptr, 1142 cl_int * errcode_ret) CL_API_SUFFIX__VERSION_3_0; 1143 1144 #endif 1145 1146 extern CL_API_ENTRY cl_int CL_API_CALL 1147 clRetainMemObject(cl_mem memobj) CL_API_SUFFIX__VERSION_1_0; 1148 1149 extern CL_API_ENTRY cl_int CL_API_CALL 1150 clReleaseMemObject(cl_mem memobj) CL_API_SUFFIX__VERSION_1_0; 1151 1152 extern CL_API_ENTRY cl_int CL_API_CALL 1153 clGetSupportedImageFormats(cl_context context, 1154 cl_mem_flags flags, 1155 cl_mem_object_type image_type, 1156 cl_uint num_entries, 1157 cl_image_format * image_formats, 1158 cl_uint * num_image_formats) CL_API_SUFFIX__VERSION_1_0; 1159 1160 extern CL_API_ENTRY cl_int CL_API_CALL 1161 clGetMemObjectInfo(cl_mem memobj, 1162 cl_mem_info param_name, 1163 size_t param_value_size, 1164 void * param_value, 1165 size_t * param_value_size_ret) CL_API_SUFFIX__VERSION_1_0; 1166 1167 extern CL_API_ENTRY cl_int CL_API_CALL 1168 clGetImageInfo(cl_mem image, 1169 cl_image_info param_name, 1170 size_t param_value_size, 1171 void * param_value, 1172 size_t * param_value_size_ret) CL_API_SUFFIX__VERSION_1_0; 1173 1174 #ifdef CL_VERSION_2_0 1175 1176 extern CL_API_ENTRY cl_int CL_API_CALL 1177 clGetPipeInfo(cl_mem pipe, 1178 cl_pipe_info param_name, 1179 size_t param_value_size, 1180 void * param_value, 1181 size_t * param_value_size_ret) CL_API_SUFFIX__VERSION_2_0; 1182 1183 #endif 1184 1185 #ifdef CL_VERSION_1_1 1186 1187 extern CL_API_ENTRY cl_int CL_API_CALL 1188 clSetMemObjectDestructorCallback(cl_mem memobj, 1189 void (CL_CALLBACK * pfn_notify)(cl_mem memobj, 1190 void * user_data), 1191 void * user_data) CL_API_SUFFIX__VERSION_1_1; 1192 1193 #endif 1194 1195 /* SVM Allocation APIs */ 1196 1197 #ifdef CL_VERSION_2_0 1198 1199 extern CL_API_ENTRY void * CL_API_CALL 1200 clSVMAlloc(cl_context context, 1201 cl_svm_mem_flags flags, 1202 size_t size, 1203 cl_uint alignment) CL_API_SUFFIX__VERSION_2_0; 1204 1205 extern CL_API_ENTRY void CL_API_CALL 1206 clSVMFree(cl_context context, 1207 void * svm_pointer) CL_API_SUFFIX__VERSION_2_0; 1208 1209 #endif 1210 1211 /* Sampler APIs */ 1212 1213 #ifdef CL_VERSION_2_0 1214 1215 extern CL_API_ENTRY cl_sampler CL_API_CALL 1216 clCreateSamplerWithProperties(cl_context context, 1217 const cl_sampler_properties * sampler_properties, 1218 cl_int * errcode_ret) CL_API_SUFFIX__VERSION_2_0; 1219 1220 #endif 1221 1222 extern CL_API_ENTRY cl_int CL_API_CALL 1223 clRetainSampler(cl_sampler sampler) CL_API_SUFFIX__VERSION_1_0; 1224 1225 extern CL_API_ENTRY cl_int CL_API_CALL 1226 clReleaseSampler(cl_sampler sampler) CL_API_SUFFIX__VERSION_1_0; 1227 1228 extern CL_API_ENTRY cl_int CL_API_CALL 1229 clGetSamplerInfo(cl_sampler sampler, 1230 cl_sampler_info param_name, 1231 size_t param_value_size, 1232 void * param_value, 1233 size_t * param_value_size_ret) CL_API_SUFFIX__VERSION_1_0; 1234 1235 /* Program Object APIs */ 1236 extern CL_API_ENTRY cl_program CL_API_CALL 1237 clCreateProgramWithSource(cl_context context, 1238 cl_uint count, 1239 const char ** strings, 1240 const size_t * lengths, 1241 cl_int * errcode_ret) CL_API_SUFFIX__VERSION_1_0; 1242 1243 extern CL_API_ENTRY cl_program CL_API_CALL 1244 clCreateProgramWithBinary(cl_context context, 1245 cl_uint num_devices, 1246 const cl_device_id * device_list, 1247 const size_t * lengths, 1248 const unsigned char ** binaries, 1249 cl_int * binary_status, 1250 cl_int * errcode_ret) CL_API_SUFFIX__VERSION_1_0; 1251 1252 #ifdef CL_VERSION_1_2 1253 1254 extern CL_API_ENTRY cl_program CL_API_CALL 1255 clCreateProgramWithBuiltInKernels(cl_context context, 1256 cl_uint num_devices, 1257 const cl_device_id * device_list, 1258 const char * kernel_names, 1259 cl_int * errcode_ret) CL_API_SUFFIX__VERSION_1_2; 1260 1261 #endif 1262 1263 #ifdef CL_VERSION_2_1 1264 1265 extern CL_API_ENTRY cl_program CL_API_CALL 1266 clCreateProgramWithIL(cl_context context, 1267 const void* il, 1268 size_t length, 1269 cl_int* errcode_ret) CL_API_SUFFIX__VERSION_2_1; 1270 1271 #endif 1272 1273 extern CL_API_ENTRY cl_int CL_API_CALL 1274 clRetainProgram(cl_program program) CL_API_SUFFIX__VERSION_1_0; 1275 1276 extern CL_API_ENTRY cl_int CL_API_CALL 1277 clReleaseProgram(cl_program program) CL_API_SUFFIX__VERSION_1_0; 1278 1279 extern CL_API_ENTRY cl_int CL_API_CALL 1280 clBuildProgram(cl_program program, 1281 cl_uint num_devices, 1282 const cl_device_id * device_list, 1283 const char * options, 1284 void (CL_CALLBACK * pfn_notify)(cl_program program, 1285 void * user_data), 1286 void * user_data) CL_API_SUFFIX__VERSION_1_0; 1287 1288 #ifdef CL_VERSION_1_2 1289 1290 extern CL_API_ENTRY cl_int CL_API_CALL 1291 clCompileProgram(cl_program program, 1292 cl_uint num_devices, 1293 const cl_device_id * device_list, 1294 const char * options, 1295 cl_uint num_input_headers, 1296 const cl_program * input_headers, 1297 const char ** header_include_names, 1298 void (CL_CALLBACK * pfn_notify)(cl_program program, 1299 void * user_data), 1300 void * user_data) CL_API_SUFFIX__VERSION_1_2; 1301 1302 extern CL_API_ENTRY cl_program CL_API_CALL 1303 clLinkProgram(cl_context context, 1304 cl_uint num_devices, 1305 const cl_device_id * device_list, 1306 const char * options, 1307 cl_uint num_input_programs, 1308 const cl_program * input_programs, 1309 void (CL_CALLBACK * pfn_notify)(cl_program program, 1310 void * user_data), 1311 void * user_data, 1312 cl_int * errcode_ret) CL_API_SUFFIX__VERSION_1_2; 1313 1314 #endif 1315 1316 #ifdef CL_VERSION_2_2 1317 1318 extern CL_API_ENTRY CL_API_PREFIX__VERSION_2_2_DEPRECATED cl_int CL_API_CALL 1319 clSetProgramReleaseCallback(cl_program program, 1320 void (CL_CALLBACK * pfn_notify)(cl_program program, 1321 void * user_data), 1322 void * user_data) CL_API_SUFFIX__VERSION_2_2_DEPRECATED; 1323 1324 extern CL_API_ENTRY cl_int CL_API_CALL 1325 clSetProgramSpecializationConstant(cl_program program, 1326 cl_uint spec_id, 1327 size_t spec_size, 1328 const void* spec_value) CL_API_SUFFIX__VERSION_2_2; 1329 1330 #endif 1331 1332 #ifdef CL_VERSION_1_2 1333 1334 extern CL_API_ENTRY cl_int CL_API_CALL 1335 clUnloadPlatformCompiler(cl_platform_id platform) CL_API_SUFFIX__VERSION_1_2; 1336 1337 #endif 1338 1339 extern CL_API_ENTRY cl_int CL_API_CALL 1340 clGetProgramInfo(cl_program program, 1341 cl_program_info param_name, 1342 size_t param_value_size, 1343 void * param_value, 1344 size_t * param_value_size_ret) CL_API_SUFFIX__VERSION_1_0; 1345 1346 extern CL_API_ENTRY cl_int CL_API_CALL 1347 clGetProgramBuildInfo(cl_program program, 1348 cl_device_id device, 1349 cl_program_build_info param_name, 1350 size_t param_value_size, 1351 void * param_value, 1352 size_t * param_value_size_ret) CL_API_SUFFIX__VERSION_1_0; 1353 1354 /* Kernel Object APIs */ 1355 extern CL_API_ENTRY cl_kernel CL_API_CALL 1356 clCreateKernel(cl_program program, 1357 const char * kernel_name, 1358 cl_int * errcode_ret) CL_API_SUFFIX__VERSION_1_0; 1359 1360 extern CL_API_ENTRY cl_int CL_API_CALL 1361 clCreateKernelsInProgram(cl_program program, 1362 cl_uint num_kernels, 1363 cl_kernel * kernels, 1364 cl_uint * num_kernels_ret) CL_API_SUFFIX__VERSION_1_0; 1365 1366 #ifdef CL_VERSION_2_1 1367 1368 extern CL_API_ENTRY cl_kernel CL_API_CALL 1369 clCloneKernel(cl_kernel source_kernel, 1370 cl_int* errcode_ret) CL_API_SUFFIX__VERSION_2_1; 1371 1372 #endif 1373 1374 extern CL_API_ENTRY cl_int CL_API_CALL 1375 clRetainKernel(cl_kernel kernel) CL_API_SUFFIX__VERSION_1_0; 1376 1377 extern CL_API_ENTRY cl_int CL_API_CALL 1378 clReleaseKernel(cl_kernel kernel) CL_API_SUFFIX__VERSION_1_0; 1379 1380 extern CL_API_ENTRY cl_int CL_API_CALL 1381 clSetKernelArg(cl_kernel kernel, 1382 cl_uint arg_index, 1383 size_t arg_size, 1384 const void * arg_value) CL_API_SUFFIX__VERSION_1_0; 1385 1386 #ifdef CL_VERSION_2_0 1387 1388 extern CL_API_ENTRY cl_int CL_API_CALL 1389 clSetKernelArgSVMPointer(cl_kernel kernel, 1390 cl_uint arg_index, 1391 const void * arg_value) CL_API_SUFFIX__VERSION_2_0; 1392 1393 extern CL_API_ENTRY cl_int CL_API_CALL 1394 clSetKernelExecInfo(cl_kernel kernel, 1395 cl_kernel_exec_info param_name, 1396 size_t param_value_size, 1397 const void * param_value) CL_API_SUFFIX__VERSION_2_0; 1398 1399 #endif 1400 1401 extern CL_API_ENTRY cl_int CL_API_CALL 1402 clGetKernelInfo(cl_kernel kernel, 1403 cl_kernel_info param_name, 1404 size_t param_value_size, 1405 void * param_value, 1406 size_t * param_value_size_ret) CL_API_SUFFIX__VERSION_1_0; 1407 1408 #ifdef CL_VERSION_1_2 1409 1410 extern CL_API_ENTRY cl_int CL_API_CALL 1411 clGetKernelArgInfo(cl_kernel kernel, 1412 cl_uint arg_indx, 1413 cl_kernel_arg_info param_name, 1414 size_t param_value_size, 1415 void * param_value, 1416 size_t * param_value_size_ret) CL_API_SUFFIX__VERSION_1_2; 1417 1418 #endif 1419 1420 extern CL_API_ENTRY cl_int CL_API_CALL 1421 clGetKernelWorkGroupInfo(cl_kernel kernel, 1422 cl_device_id device, 1423 cl_kernel_work_group_info param_name, 1424 size_t param_value_size, 1425 void * param_value, 1426 size_t * param_value_size_ret) CL_API_SUFFIX__VERSION_1_0; 1427 1428 #ifdef CL_VERSION_2_1 1429 1430 extern CL_API_ENTRY cl_int CL_API_CALL 1431 clGetKernelSubGroupInfo(cl_kernel kernel, 1432 cl_device_id device, 1433 cl_kernel_sub_group_info param_name, 1434 size_t input_value_size, 1435 const void* input_value, 1436 size_t param_value_size, 1437 void* param_value, 1438 size_t* param_value_size_ret) CL_API_SUFFIX__VERSION_2_1; 1439 1440 #endif 1441 1442 /* Event Object APIs */ 1443 extern CL_API_ENTRY cl_int CL_API_CALL 1444 clWaitForEvents(cl_uint num_events, 1445 const cl_event * event_list) CL_API_SUFFIX__VERSION_1_0; 1446 1447 extern CL_API_ENTRY cl_int CL_API_CALL 1448 clGetEventInfo(cl_event event, 1449 cl_event_info param_name, 1450 size_t param_value_size, 1451 void * param_value, 1452 size_t * param_value_size_ret) CL_API_SUFFIX__VERSION_1_0; 1453 1454 #ifdef CL_VERSION_1_1 1455 1456 extern CL_API_ENTRY cl_event CL_API_CALL 1457 clCreateUserEvent(cl_context context, 1458 cl_int * errcode_ret) CL_API_SUFFIX__VERSION_1_1; 1459 1460 #endif 1461 1462 extern CL_API_ENTRY cl_int CL_API_CALL 1463 clRetainEvent(cl_event event) CL_API_SUFFIX__VERSION_1_0; 1464 1465 extern CL_API_ENTRY cl_int CL_API_CALL 1466 clReleaseEvent(cl_event event) CL_API_SUFFIX__VERSION_1_0; 1467 1468 #ifdef CL_VERSION_1_1 1469 1470 extern CL_API_ENTRY cl_int CL_API_CALL 1471 clSetUserEventStatus(cl_event event, 1472 cl_int execution_status) CL_API_SUFFIX__VERSION_1_1; 1473 1474 extern CL_API_ENTRY cl_int CL_API_CALL 1475 clSetEventCallback(cl_event event, 1476 cl_int command_exec_callback_type, 1477 void (CL_CALLBACK * pfn_notify)(cl_event event, 1478 cl_int event_command_status, 1479 void * user_data), 1480 void * user_data) CL_API_SUFFIX__VERSION_1_1; 1481 1482 #endif 1483 1484 /* Profiling APIs */ 1485 extern CL_API_ENTRY cl_int CL_API_CALL 1486 clGetEventProfilingInfo(cl_event event, 1487 cl_profiling_info param_name, 1488 size_t param_value_size, 1489 void * param_value, 1490 size_t * param_value_size_ret) CL_API_SUFFIX__VERSION_1_0; 1491 1492 /* Flush and Finish APIs */ 1493 extern CL_API_ENTRY cl_int CL_API_CALL 1494 clFlush(cl_command_queue command_queue) CL_API_SUFFIX__VERSION_1_0; 1495 1496 extern CL_API_ENTRY cl_int CL_API_CALL 1497 clFinish(cl_command_queue command_queue) CL_API_SUFFIX__VERSION_1_0; 1498 1499 /* Enqueued Commands APIs */ 1500 extern CL_API_ENTRY cl_int CL_API_CALL 1501 clEnqueueReadBuffer(cl_command_queue command_queue, 1502 cl_mem buffer, 1503 cl_bool blocking_read, 1504 size_t offset, 1505 size_t size, 1506 void * ptr, 1507 cl_uint num_events_in_wait_list, 1508 const cl_event * event_wait_list, 1509 cl_event * event) CL_API_SUFFIX__VERSION_1_0; 1510 1511 #ifdef CL_VERSION_1_1 1512 1513 extern CL_API_ENTRY cl_int CL_API_CALL 1514 clEnqueueReadBufferRect(cl_command_queue command_queue, 1515 cl_mem buffer, 1516 cl_bool blocking_read, 1517 const size_t * buffer_origin, 1518 const size_t * host_origin, 1519 const size_t * region, 1520 size_t buffer_row_pitch, 1521 size_t buffer_slice_pitch, 1522 size_t host_row_pitch, 1523 size_t host_slice_pitch, 1524 void * ptr, 1525 cl_uint num_events_in_wait_list, 1526 const cl_event * event_wait_list, 1527 cl_event * event) CL_API_SUFFIX__VERSION_1_1; 1528 1529 #endif 1530 1531 extern CL_API_ENTRY cl_int CL_API_CALL 1532 clEnqueueWriteBuffer(cl_command_queue command_queue, 1533 cl_mem buffer, 1534 cl_bool blocking_write, 1535 size_t offset, 1536 size_t size, 1537 const void * ptr, 1538 cl_uint num_events_in_wait_list, 1539 const cl_event * event_wait_list, 1540 cl_event * event) CL_API_SUFFIX__VERSION_1_0; 1541 1542 #ifdef CL_VERSION_1_1 1543 1544 extern CL_API_ENTRY cl_int CL_API_CALL 1545 clEnqueueWriteBufferRect(cl_command_queue command_queue, 1546 cl_mem buffer, 1547 cl_bool blocking_write, 1548 const size_t * buffer_origin, 1549 const size_t * host_origin, 1550 const size_t * region, 1551 size_t buffer_row_pitch, 1552 size_t buffer_slice_pitch, 1553 size_t host_row_pitch, 1554 size_t host_slice_pitch, 1555 const void * ptr, 1556 cl_uint num_events_in_wait_list, 1557 const cl_event * event_wait_list, 1558 cl_event * event) CL_API_SUFFIX__VERSION_1_1; 1559 1560 #endif 1561 1562 #ifdef CL_VERSION_1_2 1563 1564 extern CL_API_ENTRY cl_int CL_API_CALL 1565 clEnqueueFillBuffer(cl_command_queue command_queue, 1566 cl_mem buffer, 1567 const void * pattern, 1568 size_t pattern_size, 1569 size_t offset, 1570 size_t size, 1571 cl_uint num_events_in_wait_list, 1572 const cl_event * event_wait_list, 1573 cl_event * event) CL_API_SUFFIX__VERSION_1_2; 1574 1575 #endif 1576 1577 extern CL_API_ENTRY cl_int CL_API_CALL 1578 clEnqueueCopyBuffer(cl_command_queue command_queue, 1579 cl_mem src_buffer, 1580 cl_mem dst_buffer, 1581 size_t src_offset, 1582 size_t dst_offset, 1583 size_t size, 1584 cl_uint num_events_in_wait_list, 1585 const cl_event * event_wait_list, 1586 cl_event * event) CL_API_SUFFIX__VERSION_1_0; 1587 1588 #ifdef CL_VERSION_1_1 1589 1590 extern CL_API_ENTRY cl_int CL_API_CALL 1591 clEnqueueCopyBufferRect(cl_command_queue command_queue, 1592 cl_mem src_buffer, 1593 cl_mem dst_buffer, 1594 const size_t * src_origin, 1595 const size_t * dst_origin, 1596 const size_t * region, 1597 size_t src_row_pitch, 1598 size_t src_slice_pitch, 1599 size_t dst_row_pitch, 1600 size_t dst_slice_pitch, 1601 cl_uint num_events_in_wait_list, 1602 const cl_event * event_wait_list, 1603 cl_event * event) CL_API_SUFFIX__VERSION_1_1; 1604 1605 #endif 1606 1607 extern CL_API_ENTRY cl_int CL_API_CALL 1608 clEnqueueReadImage(cl_command_queue command_queue, 1609 cl_mem image, 1610 cl_bool blocking_read, 1611 const size_t * origin, 1612 const size_t * region, 1613 size_t row_pitch, 1614 size_t slice_pitch, 1615 void * ptr, 1616 cl_uint num_events_in_wait_list, 1617 const cl_event * event_wait_list, 1618 cl_event * event) CL_API_SUFFIX__VERSION_1_0; 1619 1620 extern CL_API_ENTRY cl_int CL_API_CALL 1621 clEnqueueWriteImage(cl_command_queue command_queue, 1622 cl_mem image, 1623 cl_bool blocking_write, 1624 const size_t * origin, 1625 const size_t * region, 1626 size_t input_row_pitch, 1627 size_t input_slice_pitch, 1628 const void * ptr, 1629 cl_uint num_events_in_wait_list, 1630 const cl_event * event_wait_list, 1631 cl_event * event) CL_API_SUFFIX__VERSION_1_0; 1632 1633 #ifdef CL_VERSION_1_2 1634 1635 extern CL_API_ENTRY cl_int CL_API_CALL 1636 clEnqueueFillImage(cl_command_queue command_queue, 1637 cl_mem image, 1638 const void * fill_color, 1639 const size_t * origin, 1640 const size_t * region, 1641 cl_uint num_events_in_wait_list, 1642 const cl_event * event_wait_list, 1643 cl_event * event) CL_API_SUFFIX__VERSION_1_2; 1644 1645 #endif 1646 1647 extern CL_API_ENTRY cl_int CL_API_CALL 1648 clEnqueueCopyImage(cl_command_queue command_queue, 1649 cl_mem src_image, 1650 cl_mem dst_image, 1651 const size_t * src_origin, 1652 const size_t * dst_origin, 1653 const size_t * region, 1654 cl_uint num_events_in_wait_list, 1655 const cl_event * event_wait_list, 1656 cl_event * event) CL_API_SUFFIX__VERSION_1_0; 1657 1658 extern CL_API_ENTRY cl_int CL_API_CALL 1659 clEnqueueCopyImageToBuffer(cl_command_queue command_queue, 1660 cl_mem src_image, 1661 cl_mem dst_buffer, 1662 const size_t * src_origin, 1663 const size_t * region, 1664 size_t dst_offset, 1665 cl_uint num_events_in_wait_list, 1666 const cl_event * event_wait_list, 1667 cl_event * event) CL_API_SUFFIX__VERSION_1_0; 1668 1669 extern CL_API_ENTRY cl_int CL_API_CALL 1670 clEnqueueCopyBufferToImage(cl_command_queue command_queue, 1671 cl_mem src_buffer, 1672 cl_mem dst_image, 1673 size_t src_offset, 1674 const size_t * dst_origin, 1675 const size_t * region, 1676 cl_uint num_events_in_wait_list, 1677 const cl_event * event_wait_list, 1678 cl_event * event) CL_API_SUFFIX__VERSION_1_0; 1679 1680 extern CL_API_ENTRY void * CL_API_CALL 1681 clEnqueueMapBuffer(cl_command_queue command_queue, 1682 cl_mem buffer, 1683 cl_bool blocking_map, 1684 cl_map_flags map_flags, 1685 size_t offset, 1686 size_t size, 1687 cl_uint num_events_in_wait_list, 1688 const cl_event * event_wait_list, 1689 cl_event * event, 1690 cl_int * errcode_ret) CL_API_SUFFIX__VERSION_1_0; 1691 1692 extern CL_API_ENTRY void * CL_API_CALL 1693 clEnqueueMapImage(cl_command_queue command_queue, 1694 cl_mem image, 1695 cl_bool blocking_map, 1696 cl_map_flags map_flags, 1697 const size_t * origin, 1698 const size_t * region, 1699 size_t * image_row_pitch, 1700 size_t * image_slice_pitch, 1701 cl_uint num_events_in_wait_list, 1702 const cl_event * event_wait_list, 1703 cl_event * event, 1704 cl_int * errcode_ret) CL_API_SUFFIX__VERSION_1_0; 1705 1706 extern CL_API_ENTRY cl_int CL_API_CALL 1707 clEnqueueUnmapMemObject(cl_command_queue command_queue, 1708 cl_mem memobj, 1709 void * mapped_ptr, 1710 cl_uint num_events_in_wait_list, 1711 const cl_event * event_wait_list, 1712 cl_event * event) CL_API_SUFFIX__VERSION_1_0; 1713 1714 #ifdef CL_VERSION_1_2 1715 1716 extern CL_API_ENTRY cl_int CL_API_CALL 1717 clEnqueueMigrateMemObjects(cl_command_queue command_queue, 1718 cl_uint num_mem_objects, 1719 const cl_mem * mem_objects, 1720 cl_mem_migration_flags flags, 1721 cl_uint num_events_in_wait_list, 1722 const cl_event * event_wait_list, 1723 cl_event * event) CL_API_SUFFIX__VERSION_1_2; 1724 1725 #endif 1726 1727 extern CL_API_ENTRY cl_int CL_API_CALL 1728 clEnqueueNDRangeKernel(cl_command_queue command_queue, 1729 cl_kernel kernel, 1730 cl_uint work_dim, 1731 const size_t * global_work_offset, 1732 const size_t * global_work_size, 1733 const size_t * local_work_size, 1734 cl_uint num_events_in_wait_list, 1735 const cl_event * event_wait_list, 1736 cl_event * event) CL_API_SUFFIX__VERSION_1_0; 1737 1738 extern CL_API_ENTRY cl_int CL_API_CALL 1739 clEnqueueNativeKernel(cl_command_queue command_queue, 1740 void (CL_CALLBACK * user_func)(void *), 1741 void * args, 1742 size_t cb_args, 1743 cl_uint num_mem_objects, 1744 const cl_mem * mem_list, 1745 const void ** args_mem_loc, 1746 cl_uint num_events_in_wait_list, 1747 const cl_event * event_wait_list, 1748 cl_event * event) CL_API_SUFFIX__VERSION_1_0; 1749 1750 #ifdef CL_VERSION_1_2 1751 1752 extern CL_API_ENTRY cl_int CL_API_CALL 1753 clEnqueueMarkerWithWaitList(cl_command_queue command_queue, 1754 cl_uint num_events_in_wait_list, 1755 const cl_event * event_wait_list, 1756 cl_event * event) CL_API_SUFFIX__VERSION_1_2; 1757 1758 extern CL_API_ENTRY cl_int CL_API_CALL 1759 clEnqueueBarrierWithWaitList(cl_command_queue command_queue, 1760 cl_uint num_events_in_wait_list, 1761 const cl_event * event_wait_list, 1762 cl_event * event) CL_API_SUFFIX__VERSION_1_2; 1763 1764 #endif 1765 1766 #ifdef CL_VERSION_2_0 1767 1768 extern CL_API_ENTRY cl_int CL_API_CALL 1769 clEnqueueSVMFree(cl_command_queue command_queue, 1770 cl_uint num_svm_pointers, 1771 void * svm_pointers[], 1772 void (CL_CALLBACK * pfn_free_func)(cl_command_queue queue, 1773 cl_uint num_svm_pointers, 1774 void * svm_pointers[], 1775 void * user_data), 1776 void * user_data, 1777 cl_uint num_events_in_wait_list, 1778 const cl_event * event_wait_list, 1779 cl_event * event) CL_API_SUFFIX__VERSION_2_0; 1780 1781 extern CL_API_ENTRY cl_int CL_API_CALL 1782 clEnqueueSVMMemcpy(cl_command_queue command_queue, 1783 cl_bool blocking_copy, 1784 void * dst_ptr, 1785 const void * src_ptr, 1786 size_t size, 1787 cl_uint num_events_in_wait_list, 1788 const cl_event * event_wait_list, 1789 cl_event * event) CL_API_SUFFIX__VERSION_2_0; 1790 1791 extern CL_API_ENTRY cl_int CL_API_CALL 1792 clEnqueueSVMMemFill(cl_command_queue command_queue, 1793 void * svm_ptr, 1794 const void * pattern, 1795 size_t pattern_size, 1796 size_t size, 1797 cl_uint num_events_in_wait_list, 1798 const cl_event * event_wait_list, 1799 cl_event * event) CL_API_SUFFIX__VERSION_2_0; 1800 1801 extern CL_API_ENTRY cl_int CL_API_CALL 1802 clEnqueueSVMMap(cl_command_queue command_queue, 1803 cl_bool blocking_map, 1804 cl_map_flags flags, 1805 void * svm_ptr, 1806 size_t size, 1807 cl_uint num_events_in_wait_list, 1808 const cl_event * event_wait_list, 1809 cl_event * event) CL_API_SUFFIX__VERSION_2_0; 1810 1811 extern CL_API_ENTRY cl_int CL_API_CALL 1812 clEnqueueSVMUnmap(cl_command_queue command_queue, 1813 void * svm_ptr, 1814 cl_uint num_events_in_wait_list, 1815 const cl_event * event_wait_list, 1816 cl_event * event) CL_API_SUFFIX__VERSION_2_0; 1817 1818 #endif 1819 1820 #ifdef CL_VERSION_2_1 1821 1822 extern CL_API_ENTRY cl_int CL_API_CALL 1823 clEnqueueSVMMigrateMem(cl_command_queue command_queue, 1824 cl_uint num_svm_pointers, 1825 const void ** svm_pointers, 1826 const size_t * sizes, 1827 cl_mem_migration_flags flags, 1828 cl_uint num_events_in_wait_list, 1829 const cl_event * event_wait_list, 1830 cl_event * event) CL_API_SUFFIX__VERSION_2_1; 1831 1832 #endif 1833 1834 #ifdef CL_VERSION_1_2 1835 1836 /* Extension function access 1837 * 1838 * Returns the extension function address for the given function name, 1839 * or NULL if a valid function can not be found. The client must 1840 * check to make sure the address is not NULL, before using or 1841 * calling the returned function address. 1842 */ 1843 extern CL_API_ENTRY void * CL_API_CALL 1844 clGetExtensionFunctionAddressForPlatform(cl_platform_id platform, 1845 const char * func_name) CL_API_SUFFIX__VERSION_1_2; 1846 1847 #endif 1848 1849 #ifdef CL_USE_DEPRECATED_OPENCL_1_0_APIS 1850 /* 1851 * WARNING: 1852 * This API introduces mutable state into the OpenCL implementation. It has been REMOVED 1853 * to better facilitate thread safety. The 1.0 API is not thread safe. It is not tested by the 1854 * OpenCL 1.1 conformance test, and consequently may not work or may not work dependably. 1855 * It is likely to be non-performant. Use of this API is not advised. Use at your own risk. 1856 * 1857 * Software developers previously relying on this API are instructed to set the command queue 1858 * properties when creating the queue, instead. 1859 */ 1860 extern CL_API_ENTRY cl_int CL_API_CALL 1861 clSetCommandQueueProperty(cl_command_queue command_queue, 1862 cl_command_queue_properties properties, 1863 cl_bool enable, 1864 cl_command_queue_properties * old_properties) CL_API_SUFFIX__VERSION_1_0_DEPRECATED; 1865 #endif /* CL_USE_DEPRECATED_OPENCL_1_0_APIS */ 1866 1867 /* Deprecated OpenCL 1.1 APIs */ 1868 extern CL_API_ENTRY CL_API_PREFIX__VERSION_1_1_DEPRECATED cl_mem CL_API_CALL 1869 clCreateImage2D(cl_context context, 1870 cl_mem_flags flags, 1871 const cl_image_format * image_format, 1872 size_t image_width, 1873 size_t image_height, 1874 size_t image_row_pitch, 1875 void * host_ptr, 1876 cl_int * errcode_ret) CL_API_SUFFIX__VERSION_1_1_DEPRECATED; 1877 1878 extern CL_API_ENTRY CL_API_PREFIX__VERSION_1_1_DEPRECATED cl_mem CL_API_CALL 1879 clCreateImage3D(cl_context context, 1880 cl_mem_flags flags, 1881 const cl_image_format * image_format, 1882 size_t image_width, 1883 size_t image_height, 1884 size_t image_depth, 1885 size_t image_row_pitch, 1886 size_t image_slice_pitch, 1887 void * host_ptr, 1888 cl_int * errcode_ret) CL_API_SUFFIX__VERSION_1_1_DEPRECATED; 1889 1890 extern CL_API_ENTRY CL_API_PREFIX__VERSION_1_1_DEPRECATED cl_int CL_API_CALL 1891 clEnqueueMarker(cl_command_queue command_queue, 1892 cl_event * event) CL_API_SUFFIX__VERSION_1_1_DEPRECATED; 1893 1894 extern CL_API_ENTRY CL_API_PREFIX__VERSION_1_1_DEPRECATED cl_int CL_API_CALL 1895 clEnqueueWaitForEvents(cl_command_queue command_queue, 1896 cl_uint num_events, 1897 const cl_event * event_list) CL_API_SUFFIX__VERSION_1_1_DEPRECATED; 1898 1899 extern CL_API_ENTRY CL_API_PREFIX__VERSION_1_1_DEPRECATED cl_int CL_API_CALL 1900 clEnqueueBarrier(cl_command_queue command_queue) CL_API_SUFFIX__VERSION_1_1_DEPRECATED; 1901 1902 extern CL_API_ENTRY CL_API_PREFIX__VERSION_1_1_DEPRECATED cl_int CL_API_CALL 1903 clUnloadCompiler(void) CL_API_SUFFIX__VERSION_1_1_DEPRECATED; 1904 1905 extern CL_API_ENTRY CL_API_PREFIX__VERSION_1_1_DEPRECATED void * CL_API_CALL 1906 clGetExtensionFunctionAddress(const char * func_name) CL_API_SUFFIX__VERSION_1_1_DEPRECATED; 1907 1908 /* Deprecated OpenCL 2.0 APIs */ 1909 extern CL_API_ENTRY CL_API_PREFIX__VERSION_1_2_DEPRECATED cl_command_queue CL_API_CALL 1910 clCreateCommandQueue(cl_context context, 1911 cl_device_id device, 1912 cl_command_queue_properties properties, 1913 cl_int * errcode_ret) CL_API_SUFFIX__VERSION_1_2_DEPRECATED; 1914 1915 extern CL_API_ENTRY CL_API_PREFIX__VERSION_1_2_DEPRECATED cl_sampler CL_API_CALL 1916 clCreateSampler(cl_context context, 1917 cl_bool normalized_coords, 1918 cl_addressing_mode addressing_mode, 1919 cl_filter_mode filter_mode, 1920 cl_int * errcode_ret) CL_API_SUFFIX__VERSION_1_2_DEPRECATED; 1921 1922 extern CL_API_ENTRY CL_API_PREFIX__VERSION_1_2_DEPRECATED cl_int CL_API_CALL 1923 clEnqueueTask(cl_command_queue command_queue, 1924 cl_kernel kernel, 1925 cl_uint num_events_in_wait_list, 1926 const cl_event * event_wait_list, 1927 cl_event * event) CL_API_SUFFIX__VERSION_1_2_DEPRECATED; 1928 1929 #endif /* !defined(CL_NO_CORE_PROTOTYPES) */ 1930 1931 #ifdef __cplusplus 1932 } 1933 #endif 1934 1935 #endif /* __OPENCL_CL_H */ 1936