「clRetainCommandQueue」の版間の差分
提供: Tommy6
(ページの作成: {{Pathnav|OpenCL|OpenCLマニュアル|OpenCLランタイム|OpenCLランタイムAPI|コマンドキュー}} {{関数| cl_int clRetainCommandQueue<ref>[[clCreateCommand...) |
細 |
||
| 6行: | 6行: | ||
{{翻訳| | {{翻訳| | ||
| + | {{ChangeNote|1.1}} | ||
| + | |||
''command_queue'' の[[参照カウント]]をインクリメントします。 | ''command_queue'' の[[参照カウント]]をインクリメントします。 | ||
| 15行: | 17行: | ||
実行が成功した場合、[[clRetainCommandQueue]] は CL_SUCCESS を返します。そうでない場合は以下のエラーのうちひとつを返します。 | 実行が成功した場合、[[clRetainCommandQueue]] は CL_SUCCESS を返します。そうでない場合は以下のエラーのうちひとつを返します。 | ||
* CL_INVALID_COMMAND_QUEUE - ''command_queue'' が有効な[[コマンドキュー]]でないとき。 | * CL_INVALID_COMMAND_QUEUE - ''command_queue'' が有効な[[コマンドキュー]]でないとき。 | ||
| − | * CL_OUT_OF_RESOURCES - デバイス上でのリソース確保に失敗したとき。 | + | * {{ChangePlus|1.1|CL_OUT_OF_RESOURCES - デバイス上でのリソース確保に失敗したとき。}} |
| − | * CL_OUT_OF_HOST_MEMORY - ホスト上でのリソース確保に失敗したとき。 | + | * {{ChangePlus|1.1|CL_OUT_OF_HOST_MEMORY - ホスト上でのリソース確保に失敗したとき。}} |
== 変更記録 == | == 変更記録 == | ||
2014年2月9日 (日) 21:19時点における版
cl_int clRetainCommandQueue[1] (cl_command_queue command_queue)
-1.1() : OpenCL 1.1で削除
+1.1() : OpenCL 1.1で追加
command_queue の参照カウントをインクリメントします。
パラメータ
- command_queue
- 対象となるコマンドキューを指定します。
エラー
実行が成功した場合、clRetainCommandQueue は CL_SUCCESS を返します。そうでない場合は以下のエラーのうちひとつを返します。
- CL_INVALID_COMMAND_QUEUE - command_queue が有効なコマンドキューでないとき。
- +1.1(CL_OUT_OF_RESOURCES - デバイス上でのリソース確保に失敗したとき。)
- +1.1(CL_OUT_OF_HOST_MEMORY - ホスト上でのリソース確保に失敗したとき。)
変更記録
脚注
- ↑ clCreateCommandQueue は暗黙的にリテインを行います。これは、アプリケーションによって渡されたコマンドキューを取得するといった典型的な振る舞いを見せるサードパーティのライブラリなどで有用です。アプリケーションは、ライブラリに知らせることなくコマンドキューを削除できます。リテイン・リリースを関数が行えるようにすることで、ライブラリが利用していたコマンドキューが途中で使えなくなるといった問題を解決できます。
