IDirect3DDevice9::GetRenderTargetData

  • [アーティクル]

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

HRESULT 
GetRenderTargetData(
  IDirect3DSurface9* pRenderTarget,
  IDirect3DSurface9* pDestSurface
);

パラメータ

  • pRenderTarget
    レンダー ターゲットを表す IDirect3DSurface9 オブジェクトへのポインターです。
  • pDestSurface
    デスティネーション サーフェスを表す IDirect3DSurface9 オブジェクトへのポインターです。

戻り値

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

解説　

デスティネーション サーフェスは、オフスクリーン プレーン サーフェス、または D3DPOOL_SYSTEMMEM で作成されたテクスチャー (ミップマップまたはキューブ テクスチャー) のレベルでなければなりません。

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

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

  • レンダー ターゲットがマルチサンプリングされている。
  • ソース レンダー ターゲットのサイズがデスティネーション サーフェスのサイズと異なる。
  • ソース レンダー ターゲットとデスティネーション サーフェスのフォーマットが一致していない。

要件

ヘッダー: D3D9.h 宣言

ライブラリ: D3D9.lib 内容