Metode IDirect3DDevice9::GetRenderTarget (d3d9helper.h)

  • Artikel

Mengambil permukaan render-target.

Sintaks

HRESULT GetRenderTarget(
  [in]  DWORD             RenderTargetIndex,
  [out] IDirect3DSurface9 **ppRenderTarget
);

Parameter

[in] RenderTargetIndex

Jenis: DWORD

Indeks target render. Lihat Keterangan.

[out] ppRenderTarget

Jenis: IDirect3DSurface9**

Alamat penunjuk ke antarmuka IDirect3DSurface9 , mewakili permukaan target render yang dikembalikan untuk perangkat ini.

Mengembalikan nilai

Jenis: HRESULT

Jika metode berhasil, nilai yang dikembalikan adalah D3D_OK. Jika metode gagal, nilai yang dikembalikan dapat D3DERR_INVALIDCALL jika salah satu argumen tidak valid, atau D3DERR_NOTFOUND jika tidak ada target render yang tersedia untuk indeks yang diberikan.

Keterangan

Biasanya, metode yang mengembalikan status tidak akan berfungsi pada perangkat yang dibuat menggunakan D3DCREATE_PUREDEVICE. Namun, metode ini akan berfungsi bahkan pada perangkat murni karena mengembalikan antarmuka.

Perangkat sekarang dapat mendukung beberapa target render. Jumlah target render yang didukung oleh perangkat terkandung dalam anggota NumSimultaneousRTs dari D3DCAPS9. Lihat Beberapa Target Render (Direct3D 9).

Memanggil metode ini akan meningkatkan jumlah referensi internal pada antarmuka IDirect3DSurface9 . Kegagalan untuk memanggil IUnknown::Release setelah selesai menggunakan antarmuka IDirect3DSurface9 menghasilkan kebocoran memori.

Persyaratan

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

Lihat juga

IDirect3DDevice9

IDirect3DDevice9::SetRenderTarget