clCreateKernel

OpenCL > OpenCLマニュアル > OpenCLランタイム > OpneCLランタイムAPI > カーネルオブジェクト > clCreateKernel

cl_kernel clCreateKernel (cl_program program, const char *kernel_name, cl_int *errcode_ret)

カーネルオブジェクトを作成します。

パラメータ

program

正常にビルドが行われた有効なプログラムオブジェクトを指定します。

kernel_name

__kernel 修飾子をつけて宣言された関数の関数名を指定します。

errcode_ret

適切なエラーコードを返します。errcode_ret が NULL のとき、エラーコードは返されません。

エラー

プログラムオブジェクトの作成が成功すると、clCreateKernel は有効な非ゼロのカーネルオブジェクトを返し errcode_ret に CL_SUCCESS を設定します。そうでない場合は NULL を返して errcode_ret に以下のエラーのうちのひとつを設定します。

• CL_INVALID_PROGRAM - program が有効なプログラムオブジェクトでないとき。
• CL_INVALID_PROGRAM_EXECUTABLE - program に正常にビルドされた実行可能プログラムがないとき。
• CL_INVALID_KERNEL_NAME - kernel_name が program 内に見つからないとき。
• CL_INVALID_KERNEL_DEFINITION - kernel_name が与える、引数や引数の型といった __kernel 関数の関数定義が、program がビルドされたすべてのデバイスで同じでないとき。
• CL_INVALID_VALUE - kernel_name が NULL のとき。
• CL_OUT_OF_RESOURCES - デバイス上でのリソース確保に失敗したとき。
• CL_OUT_OF_HOST_MEMORY - ホスト上でのリソース確保に失敗したとき。

変更記録

脚注

―――― Revision 33, Version 1.1, The OpenCL Specification より翻訳