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