Share via

IDirect3DDevice9::GetRenderTargetData メソッド (d3d9helper.h)

  • [アーティクル]

レンダー ターゲット データをデバイス メモリからシステム メモリにコピーします。

構文

HRESULT GetRenderTargetData(
  [in] IDirect3DSurface9 *pRenderTarget,
  [in] IDirect3DSurface9 *pDestSurface
);

パラメーター

[in] pRenderTarget

種類: IDirect3DSurface9*

レンダリング ターゲットを表す IDirect3DSurface9 オブジェクトへのポインター。

[in] pDestSurface

種類: IDirect3DSurface9*

宛先サーフェスを表す IDirect3DSurface9 オブジェクトへのポインター。

戻り値

種類: HRESULT

メソッドが成功した場合、戻り値はD3D_OK。 メソッドが失敗した場合、戻り値は次のいずれかになります:D3DERR_DRIVERINTERNALERROR、D3DERR_DEVICELOST、D3DERR_INVALIDCALL。

注釈

変換先サーフェスは、画面外のプレーン サーフェスであるか、D3DPOOL_SYSTEMMEMで作成されたテクスチャ (ミップマップまたはキューブ テクスチャ) のレベルである必要があります。

ソース サーフェスは、通常のレンダー ターゲットであるか、POOL_DEFAULTで作成されたレンダー ターゲット テクスチャ (ミップマップまたはキューブ テクスチャ) のレベルである必要があります。

このメソッドは、次の場合に失敗します。

  • レンダー ターゲットはマルチサンプリングされます。
  • ソース レンダー ターゲットは、ターゲット サーフェスとは異なるサイズです。
  • ソース レンダー ターゲットとターゲット サーフェスの形式が一致しません。

要件

要件 値
対象プラットフォーム Windows
ヘッダー d3d9helper.h (D3D9.h を含む)
Library D3D9.lib

こちらもご覧ください

IDirect3DDevice9