Metode IDirect3DDevice9::BeginScene (d3d9.h)
Memulai adegan.
Sintaks
HRESULT BeginScene();
Mengembalikan nilai
Jenis: HRESULT
Jika metode berhasil, nilai yang dikembalikan adalah D3D_OK. Metode akan gagal dengan D3DERR_INVALIDCALL jika IDirect3DDevice9::BeginScene dipanggil saat sudah berada dalam pasangan IDirect3DDevice9::BeginScene/IDirect3DDevice9::EndScene . Ini hanya terjadi ketika IDirect3DDevice9::BeginScene dipanggil dua kali tanpa terlebih dahulu memanggil IDirect3DDevice9::EndScene.
Keterangan
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 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. Beberapa pasangan IDirect3DDevice9::BeginScene/IDirect3DDevice9::EndScene yang tidak berlapis antara panggilan yang akan hadir bersifat legal, tetapi memiliki lebih dari satu pasangan dapat menimbulkan kenaikan performa. Untuk mengaktifkan paralelisme maksimal antara CPU dan akselerator grafis, sebaiknya panggil IDirect3DDevice9::EndScene sejauh mungkin sebelum panggilan hadir.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Windows |
| Header | d3d9.h (termasuk D3D9.h) |
| Pustaka | D3D9.lib |