OpenCL C 常见属性与函数

核心对象与属性

cl_platform_id属性与函数

平台信息查询函数

平台属性查询参数

平台相关函数

扩展函数 (需要相应扩展支持)

使用示例代码

c

#include <CL/cl.h>
#include <stdio.h>

void printPlatformInfo(cl_platform_id platform) {
    char buffer[1024];
    
    // 获取平台名称
    clGetPlatformInfo(platform, CL_PLATFORM_NAME, sizeof(buffer), buffer, NULL);
    printf("Platform Name: %s\n", buffer);
    
    // 获取平台供应商
    clGetPlatformInfo(platform, CL_PLATFORM_VENDOR, sizeof(buffer), buffer, NULL);
    printf("Vendor: %s\n", buffer);
    
    // 获取平台版本
    clGetPlatformInfo(platform, CL_PLATFORM_VERSION, sizeof(buffer), buffer, NULL);
    printf("Version: %s\n", buffer);
    
    // 获取支持的扩展
    clGetPlatformInfo(platform, CL_PLATFORM_EXTENSIONS, sizeof(buffer), buffer, NULL);
    printf("Extensions: %s\n", buffer);
}

int main() {
    cl_platform_id platforms[4];
    cl_uint num_platforms;
    
    // 1. 获取所有平台
    cl_int err = clGetPlatformIDs(4, platforms, &num_platforms);
    if (err != CL_SUCCESS) {
        printf("Failed to get platforms: %d\n", err);
        return 1;
    }
    
    printf("Found %d OpenCL platform(s)\n", num_platforms);
    
    // 2. 打印每个平台信息
    for (cl_uint i = 0; i < num_platforms; i++) {
        printf("\n=== Platform %d ===\n", i);
        printPlatformInfo(platforms[i]);
        
        // 3. 获取平台设备信息
        cl_device_id devices[8];
        cl_uint num_devices;
        err = clGetDeviceIDs(platforms[i], CL_DEVICE_TYPE_ALL, 8, devices, &num_devices);
        if (err == CL_SUCCESS) {
            printf("Number of devices: %u\n", num_devices);
        }
    }
    
    // 4. 卸载编译器(可选)
    if (num_platforms > 0) {
        clUnloadPlatformCompiler(platforms[0]);
    }
    
    return 0;
}

平台属性常量

错误代码

最佳实践

1. 平台选择：

   c

   // 优先选择支持所需扩展的平台
   for (int i = 0; i < num_platforms; i++) {
       char extensions[2048];
       clGetPlatformInfo(platforms[i], CL_PLATFORM_EXTENSIONS, sizeof(extensions), extensions, NULL);
       if (strstr(extensions, "cl_khr_gl_sharing")) {
           // 选择支持OpenGL共享的平台
           selected_platform = platforms[i];
           break;
       }
   }

2. 版本检查：

   c

   char version[128];
   clGetPlatformInfo(platform, CL_PLATFORM_VERSION, sizeof(version), version, NULL);
   int major, minor;
   sscanf(version, "OpenCL %d.%d", &major, &minor);
   if (major >= 2) {
       // 支持OpenCL 2.x特性
   }

3. 多平台处理：

   c

   // 获取实际平台数量
   cl_uint num_platforms;
   clGetPlatformIDs(0, NULL, &num_platforms);
   
   // 分配足够空间
   cl_platform_id* platforms = malloc(sizeof(cl_platform_id) * num_platforms);
   clGetPlatformIDs(num_platforms, platforms, NULL);

cl_device_id属性与函数

设备信息查询函数

设备类型常量

设备基本信息属性

设备硬件特性属性

内存特性属性

图像支持属性

扩展功能属性

OpenCL 2.0+ 新增属性

设备分区属性(OpenCL 2.0+)

实用代码示例

c

#include <CL/cl.h>
#include <stdio.h>

void printDeviceInfo(cl_device_id device) {
    char device_name[128];
    cl_uint compute_units;
    cl_ulong mem_size;
    
    // 获取设备名称
    clGetDeviceInfo(device, CL_DEVICE_NAME, sizeof(device_name), device_name, NULL);
    printf("Device Name: %s\n", device_name);
    
    // 获取计算单元数量
    clGetDeviceInfo(device, CL_DEVICE_MAX_COMPUTE_UNITS, sizeof(compute_units), &compute_units, NULL);
    printf("Compute Units: %u\n", compute_units);
    
    // 获取全局内存大小
    clGetDeviceInfo(device, CL_DEVICE_GLOBAL_MEM_SIZE, sizeof(mem_size), &mem_size, NULL);
    printf("Global Memory: %.2f GB\n", (double)mem_size / (1024*1024*1024));
    
    // 检查OpenCL版本
    char device_version[64];
    clGetDeviceInfo(device, CL_DEVICE_VERSION, sizeof(device_version), device_version, NULL);
    printf("OpenCL Version: %s\n", device_version);
    
    // 检查扩展支持
    char extensions[2048];
    clGetDeviceInfo(device, CL_DEVICE_EXTENSIONS, sizeof(extensions), extensions, NULL);
    printf("Supports cl_khr_fp64: %s\n", strstr(extensions, "cl_khr_fp64") ? "Yes" : "No");
}

int main() {
    cl_platform_id platform;
    cl_device_id device;
    
    // 获取平台和设备
    clGetPlatformIDs(1, &platform, NULL);
    clGetDeviceIDs(platform, CL_DEVICE_TYPE_GPU, 1, &device, NULL);
    
    // 打印设备信息
    printDeviceInfo(device);
    
    return 0;
}

cl_context属性与函数

        上下文是OpenCL的核心对象，管理所有关联设备和资源。合理设置上下文属性对性能和功能有重要影响。

上下文管理函数

上下文属性常量