clEnqueueMarker

OpenCL > OpenCLマニュアル > OpenCLランタイム > OpenCLランタイムAPI > 非同期実行 > clEnqueueMarker

cl_int clEnqueueMarker (cl_command_queue command_queue, cl_event *event)

マーカーコマンドを挿入します。マーカーは、マーカーを挿入する前に挿入された全てのコマンドが完了するまで完了しません。マーカーコマンドはイベントを返します。つまり、マーカーコマンドを挿入する前に挿入された全てのコマンドが完了するまでイベントを待つことができます。

パラメータ

command_queue

コマンドキューを指定します。

event

マーカーコマンドと関連付けられたイベントオブジェクトを返します。

エラー

実行が成功した場合、clEnqueueMarker は CL_SUCCESS を返します。そうでない場合は以下のエラーのうちひとつを返します。

• CL_INVALID_COMMAND_QUEUE - command_queue が有効なコマンドキューでないとき。
• CL_INVALID_VALUE - event が NULL のとき。
• CL_OUT_OF_RESOURCES - デバイス上でのリソース確保に失敗したとき。
• CL_OUT_OF_HOST_MEMORY - ホスト上でのリソース確保に失敗したとき。

変更記録

脚注

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