clCreateContext関数はOpenCLコンテキストを生成します。

cl_context org.jocl.CL.clCreateContext(
    cl_context_properties properties, //(1)
    int num_devices, //(2)
    cl_device_id[] devices, //(3)
    CreateContextFunction pfn_notify, //(4)
    Object user_data, //(5)
    int[] errcode_ret) //(6)

CreateContextFunctionはコールバック用のインターフェースです。以下のコールバック関数をメンバー関数とします。

void function(
    java.lang.String errinfo,
    Pointer private_info,
    long cb,
    java.lang.Object user_data)

CreateContextFunctionはログやライフサイクル関係の処理に連動させることができます。

コンテキストのプロパティ名とそれに対応する値のリストを指定し、終端要素を0とします。コンテキストに対応するプラットフォームを指定できます。NULL値指定も可能です。

デバイスの種類（CPU/GPU等）を指定してコンテキストを生成します。基本的にはclCreateContextFromと同じですが、cl_device_id型へのポインタを指定する必要がなくなる等、デバイスIDの取得をコンテキスト内のデバイスコマンドに分離することができます。

cl_context org.jocl.CL.clCreateContextFromType(
    cl_context_properties properties, //(1)
    long device_type, //(2)
    CreateContextFunction pfn_notify, //(3)
    Object user_data, //(4)
    int[] errcode_ret)

clCreateContextとclCreateContextFromTypeは暗黙的リテインをします。リテインはアプリケーションからコンテキストを渡される第三者のライブラリにとって有用です。

しかし、アプリケーションがライブラリに知らせずにコンテキストを削除する事態もありえます。コンテキストを意識して明示的にリテイン、リリースすれば、有効でなくなったライブラリに使用されるコンテキストの問題を解決できます。

clRetainContext関数はコンテキストの参照カウントをインクリメント。

レファレンス参照をインクリメントします。以下の行はcontextの参照カウントを一つ増やします。

int org.jocl.CL.clRetainContext(
    cl_context context)

retainしたコンテキストは解放する必要があります。

コンテキストのメモリ領域を解放するには、参照カウントを以下のようにデクリメントします。

int org.jocl.CL.clReleaseContext(
    cl_context context)

尚、JavaバインディングではOpenCLオブジェクトの解放は自動で行なわれます。

clGetContextInfo関数はコンテキストについての情報の取得をします。

int org.jocl.CL.clGetContextInfo(
    cl_context context, //(1)
    int param_name, //(2)
    long param_value_size, //(3)
    Pointer param_value, //(4)
    long[] param_value_size_ret)