共用方式為


IDirect3DDevice9::GetRenderTargetData 方法 (d3d9.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。

備註

目的地表面必須是螢幕外純螢幕或紋理層級, (mipmap 或 Cube 紋理) 以 D3DPOOL_SYSTEMMEM 建立。

來源表面必須是一般轉譯目標或轉譯目標紋理層級, (mipmap 或 Cube 紋理) 以POOL_DEFAULT建立。

如果下列狀況,這個方法將會失敗:

  • 轉譯目標是多重取樣。
  • 來源轉譯目標的大小與目的地表面不同。
  • 來源轉譯目標和目的地表面格式不符。

規格需求

需求
目標平台 Windows
標頭 d3d9.h (包含 D3D9.h)
程式庫 D3D9.lib

另請參閱

IDirect3DDevice9