「clGetPlatformIDs」の版間の差分
提供: Tommy6
(ページの作成: {{Pathnav|OpenCL|OpenCLマニュアル|OpenCLランタイム|OpenCLプラットフォーム}} {{関数| cl_int clGetPlatformIDs (cl_uint ''num_entries'', [[cl_platfo...) |
細 |
||
(1人の利用者による、間の3版が非表示) | |||
7行: | 7行: | ||
{{翻訳| | {{翻訳| | ||
有効な[[OpenCLプラットフォーム]]のリストを取得します。 | 有効な[[OpenCLプラットフォーム]]のリストを取得します。 | ||
+ | |||
+ | {{ChangeNote|1.1}} | ||
== パラメータ == | == パラメータ == | ||
12行: | 14行: | ||
:''platforms'' に追加可能な [[cl_platform_id]] エントリの数を指定します。''platforms'' が NULL でないのなら、''num_entries'' は0より大きな値でなければなりません。 | :''platforms'' に追加可能な [[cl_platform_id]] エントリの数を指定します。''platforms'' が NULL でないのなら、''num_entries'' は0より大きな値でなければなりません。 | ||
;platforms | ;platforms | ||
− | :[[OpenCLプラットフォーム]]のリストを返します。''platforms'' 内に返された [[cl_platform_id]] の値は、特定のOpenCLプラットフォームを指定するのに用いることができます。''platforms'' が NULL | + | :[[OpenCLプラットフォーム]]のリストを返します。''platforms'' 内に返された [[cl_platform_id]] の値は、特定のOpenCLプラットフォームを指定するのに用いることができます。''platforms'' が NULL のとき、この引数は無視されます。返されるOpenCLプラットフォームの数は、「''num_entries'' で指定した値」と「有効なOpenCLプラットフォームの数」のうちの値が小さなほうになります。 |
;num_platforms | ;num_platforms | ||
:有効な[[OpenCLプラットフォーム]]の数を返します。''num_platforms'' が NULL のとき、この引数は無視されます。 | :有効な[[OpenCLプラットフォーム]]の数を返します。''num_platforms'' が NULL のとき、この引数は無視されます。 | ||
18行: | 20行: | ||
== エラー == | == エラー == | ||
実行が成功した場合、[[clGetPlatformIDs]] は CL_SUCCESS を返します。そうでない場合は以下のエラーのうちひとつを返します。 | 実行が成功した場合、[[clGetPlatformIDs]] は CL_SUCCESS を返します。そうでない場合は以下のエラーのうちひとつを返します。 | ||
− | |||
− | |||
* CL_INVALID_VALUE - ''num_entries'' が0でかつ ''platforms'' が NULL でないとき。あるいは、''num_platforms'' と ''platforms'' の両方が NULL のとき。 | * CL_INVALID_VALUE - ''num_entries'' が0でかつ ''platforms'' が NULL でないとき。あるいは、''num_platforms'' と ''platforms'' の両方が NULL のとき。 | ||
− | * | + | * {{ChangePlus|1.1|CL_OUT_OF_HOST_MEMORY - ホスト上でのリソース確保に失敗したとき。}} |
== 変更記録 == | == 変更記録 == |
2014年2月9日 (日) 17:02時点における最新版
cl_int clGetPlatformIDs (cl_uint num_entries, cl_platform_id *platforms, cl_uint *num_platforms)
有効なOpenCLプラットフォームのリストを取得します。
-1.1() : OpenCL 1.1で削除
+1.1() : OpenCL 1.1で追加
パラメータ
- num_entries
- platforms に追加可能な cl_platform_id エントリの数を指定します。platforms が NULL でないのなら、num_entries は0より大きな値でなければなりません。
- platforms
- OpenCLプラットフォームのリストを返します。platforms 内に返された cl_platform_id の値は、特定のOpenCLプラットフォームを指定するのに用いることができます。platforms が NULL のとき、この引数は無視されます。返されるOpenCLプラットフォームの数は、「num_entries で指定した値」と「有効なOpenCLプラットフォームの数」のうちの値が小さなほうになります。
- num_platforms
- 有効なOpenCLプラットフォームの数を返します。num_platforms が NULL のとき、この引数は無視されます。
エラー
実行が成功した場合、clGetPlatformIDs は CL_SUCCESS を返します。そうでない場合は以下のエラーのうちひとつを返します。
- CL_INVALID_VALUE - num_entries が0でかつ platforms が NULL でないとき。あるいは、num_platforms と platforms の両方が NULL のとき。
- +1.1(CL_OUT_OF_HOST_MEMORY - ホスト上でのリソース確保に失敗したとき。)
変更記録
脚注