Windows Opencl clCreateProgramWithSource()函數

Windows Opencl clCreateProgramWithSource()函數詳細解析

函數原型

cl_program 	clCreateProgramWithSource (cl_context context, 
                             cl_uint count, 
                             const char **strings,  
                             const size_t *lengths, 
	 	 	     			cl_int *errcode_ret) 
           

為上下文建立程式對象，并将字元串數組中strings指定的源代碼加載到程式對象中。與程式對象關聯的裝置是與context關聯的裝置。

context必須是有效的OpenCL上下文。

strings是一個count指針數組，用于可選的空終止字元串，組成源代碼。

lengths參數是一個數組，其中包含每個字元串中的字元數（字元串長度）。如果lengths中的某個元素為零，則其附帶的字元串以null結尾。如果length為NULL，則lengths參數中的所有lengths都被視為以NULL結尾。傳入的任何大于零的長度值都會在其計數中排除null終結符。

errcode_ret将傳回适當的錯誤代碼。如果errcode_ret為空，則不傳回錯誤代碼

clCreateProgramWithSource傳回有效的非零程式對象，如果程式對象建立成功，則errcode_ret設定為CL_SUCCESS。否則，它将傳回一個空值，并在errcode_ret中傳回以下錯誤值之一：

1. CL_INVALID_CONTEXT 如果context不是有效的上下文。
2. CL_INVALID_VALUE 如果count為零，或者strings或strings中的任何條目為NULL。
3. CL_OUT_OF_HOST_MEMORY 如果在主機上配置設定OpenCL實作所需的資源失敗。