「clGetPlatformIDs」の版間の差分

提供: Tommy6
移動: 案内検索
(ページの作成: {{Pathnav|OpenCL|OpenCLマニュアル|OpenCLランタイム|OpenCLプラットフォーム}} {{関数| cl_int clGetPlatformIDs (cl_uint ''num_entries'', [[cl_platfo...)
 
18行: 18行:
 
== エラー ==
 
== エラー ==
 
実行が成功した場合、[[clGetPlatformIDs]] は CL_SUCCESS を返します。そうでない場合は以下のエラーのうちひとつを返します。
 
実行が成功した場合、[[clGetPlatformIDs]] は CL_SUCCESS を返します。そうでない場合は以下のエラーのうちひとつを返します。
 
<span style{{=}}"background-color:#FFEEEE;">1.1</span> : [[OpenCL 1.1]]で追加
 
 
* CL_INVALID_VALUE - ''num_entries'' が0でかつ ''platforms'' が NULL でないとき。あるいは、''num_platforms'' と ''platforms'' の両方が NULL のとき。
 
* CL_INVALID_VALUE - ''num_entries'' が0でかつ ''platforms'' が NULL でないとき。あるいは、''num_platforms'' と ''platforms'' の両方が NULL のとき。
* <span style{{=}}"background-color:#FFEEEE;">CL_OUT_OF_HOST_MEMORY - ホスト上でのリソース確保に失敗したとき。</span>
+
* CL_OUT_OF_HOST_MEMORY - ホスト上でのリソース確保に失敗したとき。
  
 
== 変更記録 ==
 
== 変更記録 ==

2010年9月15日 (水) 12:04時点における版

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

cl_int clGetPlatformIDs (cl_uint num_entries, cl_platform_id *platforms, cl_uint *num_platforms)

有効なOpenCLプラットフォームのリストを取得します。

パラメータ

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 のとき。
  • CL_OUT_OF_HOST_MEMORY - ホスト上でのリソース確保に失敗したとき。

変更記録

脚注



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