Metode IDirect3DDevice9::GetRenderTargetData (d3d9helper.h)
Menyalin data target render dari memori perangkat ke memori sistem.
Sintaks
HRESULT GetRenderTargetData(
[in] IDirect3DSurface9 *pRenderTarget,
[in] IDirect3DSurface9 *pDestSurface
);
Parameter
[in] pRenderTarget
Jenis: IDirect3DSurface9*
Penunjuk ke objek IDirect3DSurface9 , mewakili target render.
[in] pDestSurface
Jenis: IDirect3DSurface9*
Penunjuk ke objek IDirect3DSurface9 , mewakili permukaan tujuan.
Nilai kembali
Jenis: HRESULT
Jika metode berhasil, nilai yang dikembalikan D3D_OK. Jika metode gagal, nilai yang dikembalikan dapat berupa salah satu hal berikut: D3DERR_DRIVERINTERNALERROR, D3DERR_DEVICELOST, D3DERR_INVALIDCALL.
Keterangan
Permukaan tujuan harus berupa permukaan biasa di luar layar atau tingkat tekstur (mipmap atau tekstur kubus) yang dibuat dengan D3DPOOL_SYSTEMMEM.
Permukaan sumber harus menjadi target render reguler atau tingkat tekstur target render (tekstur mipmap atau kubus) yang dibuat dengan POOL_DEFAULT.
Metode ini akan gagal jika:
- Target render multisampled.
- Target render sumber adalah ukuran yang berbeda dari permukaan tujuan.
- Format target render sumber dan permukaan tujuan tidak cocok.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Windows |
| Header | d3d9helper.h (termasuk D3D9.h) |
| Pustaka | D3D9.lib |