clRetainCommandQueue/1.0

OpenCL > OpenCLマニュアル > OpenCLランタイム > OpenCLランタイムAPI > コマンドキュー > clRetainCommandQueue/1.0

OpenCL > OpenCL 1.0 > OpenCLマニュアル/1.0 > OpenCLランタイム/1.0 > OpenCLランタイムAPI/1.0 > コマンドキュー/1.0 > clRetainCommandQueue/1.0

cl_int clRetainCommandQueue[1] (cl_command_queue command_queue)

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

パラメータ

実行が成功した場合、clRetainCommandQueue は CL_SUCCESS を返します。command_queue が有効なコマンドキューでないとき、CL_INVALID_COMMAND_QUEUE を返します。

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