ホストとターゲット間のデータの読み取り/書き込み関数

インテル® C++ コンパイラー 18.0 デベロッパー・ガイドおよびリファレンス

ホストからターゲットへのデータの書き込み、またはターゲットからホストへのデータの読み取りを行います。このトピックは、インテル® グラフィックス・テクノロジーをターゲットとする場合にのみ適用されます。

構文

C++ インターフェイス

int GfxImage2D::read();

int GfxImage2D::write();

int GfxSharedImage2D::read();

int GfxSharedImage2D::write();

C インターフェイス

int _GFX_read_image_2d(GfxResourceHandle handle);

int _GFX_write_image_2d(GfxResourceHandle handle);

パラメーター

handle

_GFX_create_image_2d によって返される内部イメージ・オブジェクトへのハンドル

説明

ホストからターゲットへのイメージデータの書き込み、またはターゲットからホストへのイメージデータの読み取りを行います。これらの関数は、共有 2D イメージに対しては何も行いません。

共有イメージとターゲットイメージで同様の使用パターンを利用できるように、ターゲットイメージの内部イメージ・オブジェクトを作成するとホストからターゲットへデータがコピーされ、ターゲットイメージの内部イメージ・オブジェクトを破棄すると (まだコピーされていない場合) ターゲットからホストへイメージがコピーされます。イメージ・オブジェクトは、オフロードタスクがそのイメージを使用していないことがランタイムによって示された場合のみ破棄できるため、このコピーは安全に行えます。

戻り値

`GFX_SUCCESS (0)`	関数の実行に成功しました。
非ゼロのエラーコード	エラーが発生しました。_GFX_get_last_error() 関数を使用してエラーコードを取得してください。各種エラーステータス値は、gfx_rt.h で定義されています。