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