Metode IDirect3DDevice9::EndScene (d3d9helper.h)

  • Artikel

Mengakhiri adegan yang dimulai dengan memanggil IDirect3DDevice9::BeginScene.

Sintaks

HRESULT EndScene();

Mengembalikan nilai

Jenis: HRESULT

Jika metode berhasil, nilai yang dikembalikan D3D_OK. Metode akan gagal dengan D3DERR_INVALIDCALL jika IDirect3DDevice9::BeginScene dipanggil saat sudah berada di pasangan IDirect3DDevice9::BeginScene/IDirect3DDevice9::EndScene . Ini hanya terjadi ketika IDirect3DDevice9::BeginScene dipanggil dua kali tanpa terlebih dahulu memanggil IDirect3DDevice9::EndScene.

Keterangan

Ketika metode ini berhasil, adegan telah diantrekan untuk dirender oleh driver. Ini bukan metode sinkron, sehingga adegan tidak dijamin telah selesai dirender ketika metode ini kembali.

Aplikasi harus memanggil IDirect3DDevice9::BeginScene sebelum melakukan penyajian apa pun dan harus memanggil IDirect3DDevice9::EndScene saat penyajian selesai dan sebelum memanggil IDirect3DDevice9::BeginScene lagi.

Jika IDirect3DDevice9::BeginScene gagal, perangkat tidak dapat memulai adegan, dan tidak perlu memanggil IDirect3DDevice9::EndScene. Bahkan, panggilan ke IDirect3DDevice9::EndScene akan gagal jika IDirect3DDevice9::BeginScene sebelumnya gagal. Ini berlaku untuk aplikasi apa pun yang membuat beberapa rantai pertukaran.

Harus ada paling banyak satu pasangan IDirect3DDevice9::BeginScene/IDirect3DDevice9::EndScene antara panggilan berturut-turut untuk hadir ( baik IDirect3DDevice9::P resent atau IDirect3DSwapChain9::P resent). IDirect3DDevice9::BeginScene harus dipanggil sekali sebelum penyajian dilakukan, dan IDirect3DDevice9::EndScene harus dipanggil sekali setelah semua penyajian untuk bingkai telah dikirimkan ke runtime. Untuk mengaktifkan paralelisme maksimal antara CPU dan akselerator grafis, ada baiknya untuk memanggil IDirect3DDevice9::EndScene sejauh mungkin sebelum memanggil hadir.

Persyaratan

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

Lihat juga

IDirect3DDevice9