5.8.6.5. Options Controlling the OpenCL C Version
5.8.6.5. 控制OpenCL C版本的选项
The following option controls the version of OpenCL C that the compiler accepts. These options are ignored for programs created with IL.
以下选项控制编译器接受的OpenCL C版本。对于使用IL创建的程序,这些选项将被忽略。
-cl-std=
Determine the OpenCL C language version to use. A value for this option must be provided. Valid values are:
确定要使用的OpenCL C语言版本。必须提供此选项的值。有效值为:
-
CL1.1
: Support OpenCL C 1.1 language features defined in section 6 of the OpenCL 1.1 specification or in the unified OpenCL C specification. -
CL1.1:支持OpenCL 1.1规范第6节或统一OpenCL C规范中定义的OpenCL C 1.1语言特性。
-
CL1.2
: Support OpenCL C 1.2 language features defined in section 6 of the OpenCL 1.2 specification or in the unified OpenCL C specification. -
CL1.2:支持OpenCL 1.2规范第6节或统一OpenCL C规范中定义的OpenCL C 1.2语言特性。
-
CL2.0
: Support OpenCL C 2.0 language features defined in the OpenCL C 2.0 specification or in the unified OpenCL C specification. -
CL2.0:支持OpenCL C 2.0规范或统一OpenCL C规范中定义的OpenCL C 2.0语言特性。
-
CL3.0
: Support OpenCL C 3.0 language features defined in the unified OpenCL C specification. -
CL3.0:支持统一OpenCL C规范中定义的OpenCL C 3.0语言特性。
Calls to clBuildProgram or clCompileProgram with the -cl-std=CL1.1
option will fail to compile the program for any devices with CL_DEVICE_OPENCL_C_VERSION equal to OpenCL C 1.0 and when CL_DEVICE_OPENCL_C_ALL_VERSIONS does not include OpenCL C 1.1.
使用-cl std=CL1.1选项调用clBuildProgram或clCompileProgram将无法为CLD_OPENCL_C_VERSION等于OPENCL C 1.0的任何设备编译程序,并且当CLD_OPENCLE_C_ALL_VERSION不包括OPENCL C 1.1时。
Calls to clBuildProgram or clCompileProgram with the -cl-std=CL1.2
option will fail to compile the program for any devices with CL_DEVICE_OPENCL_C_VERSION equal to OpenCL C 1.1 or earlier and when CL_DEVICE_OPENCL_C_ALL_VERSIONS does not include OpenCL C 1.2.
使用-cl std=CL1.2选项调用clBuildProgram或clCompileProgram将无法为CLD_OPENCL_C_VERSION等于OPENCL C 1.1或更低版本的任何设备编译程序,并且CLD_OPENCL_CALL_VERSION不包括OPENCL C 1.2。
Calls to clBuildProgram or clCompileProgram with the -cl-std=CL2.0
option will fail to compile the program for any devices with CL_DEVICE_OPENCL_C_VERSION equal to OpenCL C 1.2 or earlier and when CL_DEVICE_OPENCL_C_ALL_VERSIONS does not include OpenCL C 2.0.
使用-cl std=CL2.0选项调用clBuildProgram或clCompileProgram将无法为CLD_OPENCL_C_VERSION等于OPENCL C 1.2或更低版本的任何设备编译程序,并且CLD_OPENCL_CALL_VERSION不包括OPENCL C 2.0。
Calls to clBuildProgram or clCompileProgram with the -cl-std=CL3.0
option will fail to compile the program for any devices with CL_DEVICE_OPENCL_C_VERSION equal to OpenCL C 2.0 or earlier and when CL_DEVICE_OPENCL_C_ALL_VERSIONS does not include OpenCL C 3.0.
使用-cl std=CL3.0选项调用clBuildProgram或clCompileProgram将无法为CLD_OPENCL_C_VERSION等于OPENCL C 2.0或更低版本的任何设备编译程序,并且CLD_OPENCL_CALL_VERSION不包括OPENCL C 3.0。
If the -cl-std
build option is not specified, the highest OpenCL C 1.x language version supported by each device is used when compiling the program for each device. Applications are required to specify the -cl-std=CL2.0
build option to compile or build programs with OpenCL C 2.0 and the -cl-std=CL3.0
build option to compile or build programs with OpenCL C 3.0.
如果未指定-cl-std build选项,则在为每个设备编译程序时,将使用每个设备支持的最高OpenCL C 1.x语言版本。应用程序需要指定-cl-std=CL2.0构建选项以使用OpenCL C 2.0编译或构建程序,并指定-cl-std=CL3.0构建选项以用OpenCL C 3.0编译或生成程序。