clRetainContext/1.0

OpenCL > OpenCLマニュアル > OpenCLランタイム > OpenCLコンテキスト > clRetainContext/1.0

OpenCL > OpenCL 1.0 > OpenCLマニュアル/1.0 > OpenCLランタイム/1.0 > OpenCLコンテキスト/1.0 > clRetainContext/1.0

cl_int clRetainContext[1] (cl_context context)

context の参照カウントをインクリメントします。

パラメータ

実行が成功した場合、clRetainContext は CL_SUCCESS を返します。context が有効なOpenCLコンテキストでないとき、CL_INVALID_CONTEXT を返します。

↑ clCreateContext や clCreateContextFromType は暗黙的にリテインを行います。これは、アプリケーションによって渡されたコンテキストを取得するといった典型的な振る舞いを見せるサードパーティのライブラリなどで有用です。アプリケーションは、ライブラリに知らせることなくコンテキストを削除できます。リテイン・リリースを関数が行えるようにすることで、ライブラリが利用していたコンテキストが途中で使えなくなるといった問題を解決できます。