IDirect3DDevice9::GetRenderTargetData メソッド

  • [アーティクル]

IDirect3DDevice9::GetRenderTargetData メソッド

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

構文

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

パラメータ

  • pRenderTarget
    [in] レンダリング ターゲットを表す IDirect3DSurface9 オブジェクトへのポインタ。
  • pDestSurface
    [in] 転送先サーフェイスを表す IDirect3DSurface9 オブジェクトへのポインタ。

戻り値

成功した場合は、D3D_OK を返す。

引数のいずれかが無効な場合は、D3DERR_INVALIDCALL になる。

注意

転送先サーフェイスは、D3DPOOL_SYSTEMMEM で作成したオフスクリーン プレ－ン サーフェイスまたはテクスチャ レベル (ミップマップまたはキューブ テクスチャ) でなければならない。

転送元サーフェイスは、POOL_DEFAULT で作成した通常のレンダリング ターゲットまたはレンダリング ターゲット テクスチャのレベル (ミップマップまたはキューブ テクスチャ) でなければならない。

次の場合、メソッドは失敗する。

  • レンダリング ターゲットがマルチサンプリングされた場合。
  • 転送元レンダリング ターゲットが転送先サーフェイスのサイズと異なる場合。
  • 転送元レンダリング ターゲットと転送先サーフェイスのフォーマットが一致しない場合。