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 宣言