「clRetainContext」の版間の差分
提供: Tommy6
細 |
細 |
||
7行: | 7行: | ||
{{翻訳| | {{翻訳| | ||
''context'' の[[参照カウント]]をインクリメントします。 | ''context'' の[[参照カウント]]をインクリメントします。 | ||
+ | |||
+ | {{ChangeNote|1.1}} | ||
== パラメータ == | == パラメータ == | ||
15行: | 17行: | ||
実行が成功した場合、[[clRetainContext]] は CL_SUCCESS を返します。そうでない場合は以下のエラーのうちひとつを返します。 | 実行が成功した場合、[[clRetainContext]] は CL_SUCCESS を返します。そうでない場合は以下のエラーのうちひとつを返します。 | ||
* CL_INVALID_CONTEXT - ''context'' が有効な[[OpenCLコンテキスト]]でないとき。 | * CL_INVALID_CONTEXT - ''context'' が有効な[[OpenCLコンテキスト]]でないとき。 | ||
− | * CL_OUT_OF_RESOURCES - デバイス上でのリソース確保に失敗したとき。 | + | * {{ChangePlus|CL_OUT_OF_RESOURCES - デバイス上でのリソース確保に失敗したとき。}} |
− | * CL_OUT_OF_HOST_MEMORY - ホスト上でのリソース確保に失敗したとき。 | + | * {{ChangePlus|CL_OUT_OF_HOST_MEMORY - ホスト上でのリソース確保に失敗したとき。}} |
== 変更記録 == | == 変更記録 == | ||
23行: | 25行: | ||
<references /> | <references /> | ||
− | |[http://www.khronos.org/registry/cl/specs/opencl-1.1.pdf | + | |[http://www.khronos.org/registry/cl/specs/opencl-1.1.pdf Version 1.1, The OpenCL Specification] |
}} | }} | ||
2012年4月9日 (月) 12:02時点における版
cl_int clRetainContext[1] (cl_context context)
context の参照カウントをインクリメントします。
-1.1() : OpenCL 1.1で削除
+1.1() : OpenCL 1.1で追加
パラメータ
- context
- 対象となるOpenCLコンテキストを指定します。
エラー
実行が成功した場合、clRetainContext は CL_SUCCESS を返します。そうでない場合は以下のエラーのうちひとつを返します。
- CL_INVALID_CONTEXT - context が有効なOpenCLコンテキストでないとき。
- +CL_OUT_OF_RESOURCES - デバイス上でのリソース確保に失敗したとき。()
- +CL_OUT_OF_HOST_MEMORY - ホスト上でのリソース確保に失敗したとき。()
変更記録
脚注
- ↑ clCreateContext や clCreateContextFromType は暗黙的にリテインを行います。これは、アプリケーションによって渡されたコンテキストを取得するといった典型的な振る舞いを見せるサードパーティのライブラリなどで有用です。アプリケーションは、ライブラリに知らせることなくコンテキストを削除できます。リテイン・リリースを関数が行えるようにすることで、ライブラリが利用していたコンテキストが途中で使えなくなるといった問題を解決できます。
―――― Version 1.1, The OpenCL Specification
より翻訳