Metode IDirect3DDevice9::GetRenderTargetData (d3d9.h)

  • Artikel

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 adalah 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 polos di luar layar atau tingkat tekstur (tekstur mipmap atau 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 berukuran berbeda dari permukaan tujuan.
  • Format target render sumber dan permukaan tujuan tidak cocok.

Persyaratan

Persyaratan Nilai
Target Platform Windows
Header d3d9.h (termasuk D3D9.h)
Pustaka D3D9.lib

Lihat juga

IDirect3DDevice9