clEnqueueWaitForEvents
提供: Tommy6
cl_int clEnqueueWaitForEvents (cl_command_queue command_queue, cl_uint num_events, const cl_event *event_list)
コマンドキュー内の次のコマンドが実行が始まる前に完了するのを待つ、イベント待ちを挿入します。event_list 内のそれぞれのイベントは clEnqueueNDRangeKernel, clEnqueueTask, clEnqueueNativeKernel, clEnqueue{Read|Write|Map}{Buffer|Image}, clEnqueueUnmapMemObject, clEnqueue{Read|Write}BufferRect, clEnqueueCopy{Buffer|Image}, clEnqueueCopyBufferRect, clEnqueueCopyBufferToImage, clEnqueueCopyImageToBuffer, clEnqueueMarker が返す有効なイベントオブジェクトでなければなりません。
パラメータ
- command_queue
- コマンドキューを指定します。
- num_events
- event_list のイベントオブジェクトの数を指定します。
- event_list
- 完了を待つイベントオブジェクトのリストを指定します。
エラー
実行が成功した場合、clEnqueueWaitForEvents は CL_SUCCESS を返します。そうでない場合は以下のエラーのうちひとつを返します。
- CL_INVALID_COMMAND_QUEUE - command_queue が有効なコマンドキューでないとき。
- CL_INVALID_CONTEXT - event_list 内のイベントが関連付けられているOpenCLコンテキストが同じでないとき。
- CL_INVALID_VALUE - num_events が 0 あるいは event_list が NULL のとき。
- CL_INVALID_EVENT - event_list 内のイベントオブジェクトが有効なイベントオブジェクトでないとき。
- CL_OUT_OF_RESOURCES - デバイス上でのリソース確保に失敗したとき。
- CL_OUT_OF_HOST_MEMORY - ホスト上でのリソース確保に失敗したとき。
変更記録
脚注