「clGetPlatformIDs」の版間の差分

提供: Tommy6
移動: 案内検索
 
(1人の利用者による、間の1版が非表示)
7行: 7行:
 
{{翻訳|
 
{{翻訳|
 
有効な[[OpenCLプラットフォーム]]のリストを取得します。
 
有効な[[OpenCLプラットフォーム]]のリストを取得します。
 +
 +
{{ChangeNote|1.1}}
  
 
== パラメータ ==
 
== パラメータ ==
19行: 21行:
 
実行が成功した場合、[[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 のとき。
* CL_OUT_OF_HOST_MEMORY - ホスト上でのリソース確保に失敗したとき。
+
* {{ChangePlus|1.1|CL_OUT_OF_HOST_MEMORY - ホスト上でのリソース確保に失敗したとき。}}
  
 
== 変更記録 ==
 
== 変更記録 ==

2014年2月9日 (日) 17:02時点における最新版

OpenCL > OpenCLマニュアル > OpenCLランタイム > OpenCLプラットフォーム > clGetPlatformIDs

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_platformsplatforms の両方が NULL のとき。
  • +1.1(CL_OUT_OF_HOST_MEMORY - ホスト上でのリソース確保に失敗したとき。)

変更記録

脚注



―――― Revision 33, Version 1.1, The OpenCL Specification より翻訳