clWaitForEvents

提供: Tommy6
移動: 案内検索
OpenCL > OpenCLマニュアル > OpenCLランタイム > OpenCLランタイムAPI > イベントオブジェクト > clWaitForEvents

cl_int clWaitForEvents (cl_uint num_events, const cl_event *event_list)

イベントオブジェクトに関連付けられたコマンドが完了するのをホストスレッドで待ちます。コマンドは、実行状態が CL_COMPLETE もしくは負の値になったときに完了したものとみなされます。event_list 内のイベントは同期ポイントとしてふるまいます。

パラメータ

num_events
event_list のイベントオブジェクトの数を指定します。
event_list
完了を待つイベントオブジェクトのリストを指定します。

エラー

event_list 内の全てのイベントの実行状態が CL_COMPLETE のとき、clWaitForEvents は CL_SUCCESS を返します。そうでない場合は以下のエラーのうちひとつを返します。

  • CL_INVALID_EVENT - event_list が有効なイベントオブジェクトでないとき。
  • CL_INVALID_VALUE - num_events が 0 あるいは event_list が NULL のとき。
  • CL_INVALID_CONTEXT - event_list 内のイベントが関連付けられているOpenCLコンテキストが同じでないとき。
  • CL_EXEC_STATUS_ERROR_FOR_EVENTS_IN_WAIT_LIST - event_list 内のイベントのうちいずれかの実行状態が負の値のとき。
  • CL_OUT_OF_RESOURCES - デバイス上でのリソース確保に失敗したとき。
  • CL_OUT_OF_HOST_MEMORY - ホスト上でのリソース確保に失敗したとき。

変更記録

脚注



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