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 |