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