インテル® C++ コンパイラー 17.0 デベロッパー・ガイドおよびリファレンス
インオーダーのオフロードキューにタスクを追加します。このトピックは、インテル® グラフィックス・テクノロジーをターゲットとする IA-32 およびインテル® 64 アーキテクチャーにのみ適用されます。 これは古い関数 (非推奨) です。後継関数は _GFX_offload です。
GfxTaskId _GFX_enqueue(const char * kernel_name, arg_list);
kernel_name |
カーネルの名前。カーネルエントリー関数の非マングル名と一致する文字列。 |
arg_list |
カーネルの引数リスト (変数引数リスト)。カーネルの引数リストと一致していなければなりません。ランタイムは、カーネルの属性から引数を予測できます。 |
この関数は、オフロードタスクをキューに追加するのに必要なすべての処理を行います。 カーネルエントリー関数名を用いてカーネルを指定します。 この関数は、2D イメージやポインターなどの特殊なデータ型に必要な前処理を行ってから、カーネルエントリー関数に引数を渡します。
一般的なランタイムの初期化を行う必要はありません。 この関数は、必要なすべての初期化処理がまだ行われていない場合、それらを実行します。
この関数は非ブロック関数です。タスクの完了を待機しません。
CPU とプロセッサー・グラフィックス間のディスパッチおよびタスク分割は、この関数では行われないため、明示的に行う必要があります。 これらの処理を支援するため、コンパイラーは、カーネルエントリー関数を含むすべてのターゲット関数のホストバージョンとターゲットバージョンを生成し、カーネル・エントリー・ポイントで _Cilk_for ループの互換セマンティクスを提供します。
インテル® グラフィックス・テクノロジー・ランタイムは、処理を容易にするため、1 つのデフォルトキューのみ保持します。
_GFX_enqueue で作成され、キューに追加されたタスクの完了を待機するには、_GFX_wait 関数を使用します。
この関数はスレッドセーフです。つまり、同期を追加することなく、異なるホストスレッドから利用できます。
task id |
キューに追加されているオフロードタスクのタスク ID。この値を _GFX_wait に渡してタスクの完了を待機できます。タスク ID は 64 ビットの整数値で、新しいタスクにインクリメンタルに割り当てられます。キューに追加されているタスクがユーザーによって明示的に終了および破棄されなくても、マルチスレッド環境でそれらを安全に使用できるようにします。 |
0 |
エラーが発生しました。_GFX_get_last_error() 関数を使用してエラーコードを取得してください。 |