Metode IDirect3DDevice9::EndScene (d3d9.h)
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 | d3d9.h (termasuk D3D9.h) |
| Pustaka | D3D9.lib |