CLGetInfoString

为OpenCL对象或者设备返回一个属性的字符串值.

bool  CLGetInfoString(
   int  handle,                           // OpenCL对象处理或者OpenCL设备号码
   ENUM_OPENCL_PROPERTY_STRING  prop,     // 被请求的属性
   string&  value                         // 引用字符串
   );

参数

handle

[in] OpenCL对象处理或者OpenCL设备号码. OpenCL设备编号开始于零.

prop

[in] 从 ENUM_OPENCL_PROPERTY_STRING 详表被请求的属性类型, 应当被包含的值.

value

[out] 接收属性值的字符串.

返回值

成功则返回true, 否则返回 false. 有关错误信息，使用 GetLastError() 函数.

ENUM_OPENCL_PROPERTY_STRING

标识符	描述
CL_PLATFORM_PROFILE	CL_PLATFORM_PROFILE - OpenCL简介. 简介名称可以是以下值中的某一个: FULL_PROFILE - 实现支持OpenCL（功能定义为核心规范的一部分而无需为OpenCL支持额外的扩展） ; EMBEDDED_PROFILE - 实现支持OpenCL作为增补. 修订简介被定义为每个OpenCL版本的子集.
CL_PLATFORM_VERSION	OpenCL版本
CL_PLATFORM_VENDOR	平台供应商名称
CL_PLATFORM_EXTENSIONS	由平台支持的扩展名列表。扩展名应该能被所有与这个平台相
CL_DEVICE_NAME	设备名称
CL_DEVICE_VENDOR	供应商名称
CL_DRIVER_VERSION	major_number.minor_number格式OpenCL设备版本
CL_DEVICE_PROFILE	OpenCL设备简介. 简介名称可以是以下值的某一个: FULL_PROFILE - 实现支持OpenCL（功能定义为核心规范的一部分而无需为OpenCL支持额外的扩展）; EMBEDDED_PROFILE -实现支持OpenCL作为增补. 修订简介被定义为每个OpenCL版本的子集.
CL_DEVICE_VERSION	"OpenCL<space><major_version.minor_version><space><vendor-specific information>" 格式OpenCL版本
CL_DEVICE_EXTENSIONS	设备所支持的扩展名列表。列表可以包含由供应商支持的扩展，以及一个或多个批准名称: cl_khr_int64_base_atomics cl_khr_int64_extended_atomics cl_khr_fp16 cl_khr_gl_sharing cl_khr_gl_event cl_khr_d3d10_sharing cl_khr_dx9_media_sharing cl_khr_d3d11_sharing
CL_DEVICE_BUILT_IN_KERNELS	可支持的内核列表用 ";"分割.
CL_DEVICE_OPENCL_C_VERSION	这个设备的编译器所支持的最大版本。版本格式: "OpenCL<space>C<space><major_version.minor_version><space><vendor-specific information> "
CL_ERROR_DESCRIPTION	OpenCL错误的文本描述

例如：

void OnStart()
  {
   int cl_ctx;
   string str;
//--- 初始化 OpenCL 上下文
   if((cl_ctx=CLContextCreate(CL_USE_GPU_ONLY))==INVALID_HANDLE)
     {
      Print("OpenCL not found");
      return;
     }
//--- 显示平台信息
   if(CLGetInfoString(cl_ctx,CL_PLATFORM_NAME,str))
      Print("OpenCL platform name: ",str);
   if(CLGetInfoString(cl_ctx,CL_PLATFORM_VENDOR,str))
      Print("OpenCL platform vendor: ",str);
   if(CLGetInfoString(cl_ctx,CL_PLATFORM_VERSION,str))
      Print("OpenCL platform ver: ",str);
   if(CLGetInfoString(cl_ctx,CL_PLATFORM_PROFILE,str))
      Print("OpenCL platform profile: ",str);
   if(CLGetInfoString(cl_ctx,CL_PLATFORM_EXTENSIONS,str))
      Print("OpenCL platform ext: ",str);
//--- 显示设备信息
   if(CLGetInfoString(cl_ctx,CL_DEVICE_NAME,str))
      Print("OpenCL device name: ",str);
   if(CLGetInfoString(cl_ctx,CL_DEVICE_PROFILE,str))
      Print("OpenCL device profile: ",str);
   if(CLGetInfoString(cl_ctx,CL_DEVICE_BUILT_IN_KERNELS,str))
      Print("OpenCL device kernels: ",str);
   if(CLGetInfoString(cl_ctx,CL_DEVICE_EXTENSIONS,str))
      Print("OpenCL device ext: ",str);
   if(CLGetInfoString(cl_ctx,CL_DEVICE_VENDOR,str))
      Print("OpenCL device vendor: ",str);
   if(CLGetInfoString(cl_ctx,CL_DEVICE_VERSION,str))
      Print("OpenCL device ver: ",str);
   if(CLGetInfoString(cl_ctx,CL_DEVICE_OPENCL_C_VERSION,str))
      Print("OpenCL open c ver: ",str);
//--- 显示OpenCL设备的常规信息
   Print("OpenCL type: ",EnumToString((ENUM_CL_DEVICE_TYPE)CLGetInfoInteger(cl_ctx,CL_DEVICE_TYPE)));
   Print("OpenCL vendor ID: ",CLGetInfoInteger(cl_ctx,CL_DEVICE_VENDOR_ID));
   Print("OpenCL units: ",CLGetInfoInteger(cl_ctx,CL_DEVICE_MAX_COMPUTE_UNITS));
   Print("OpenCL freq: ",CLGetInfoInteger(cl_ctx,CL_DEVICE_MAX_CLOCK_FREQUENCY));
   Print("OpenCL global mem: ",CLGetInfoInteger(cl_ctx,CL_DEVICE_GLOBAL_MEM_SIZE));
   Print("OpenCL local mem: ",CLGetInfoInteger(cl_ctx,CL_DEVICE_LOCAL_MEM_SIZE));
//--- free OpenCL context
   CLContextFree(cl_ctx);
  }

CLGetInfoInteger

CLContextCreate