Metodo IDirect3DDevice9::EndScene (d3d9.h)
Termina una scena iniziata chiamando IDirect3DDevice9::BeginScene.
Sintassi
HRESULT EndScene();
Valore restituito
Tipo: HRESULT
Se il metodo ha esito positivo, il valore restituito viene D3D_OK. Il metodo avrà esito negativo con D3DERR_INVALIDCALL se IDirect3DDevice9::BeginScene viene chiamato mentre è già in una coppia IDirect3DDevice9::BeginScene/IDirect3DDevice9::EndScene . Ciò si verifica solo quando IDirect3DDevice9::BeginScene viene chiamato due volte senza prima chiamare IDirect3DDevice9::EndScene.
Commenti
Quando questo metodo ha esito positivo, la scena è stata accodata per il rendering dal driver. Non si tratta di un metodo sincrono, pertanto non è garantito che il rendering della scena venga completato quando termina il metodo.
Le applicazioni devono chiamare IDirect3DDevice9::BeginScene prima di eseguire qualsiasi rendering e devono chiamare IDirect3DDevice9::EndScene al termine del rendering e prima di chiamare nuovamente IDirect3DDevice9::BeginScene .
Se IDirect3DDevice9::BeginScene ha esito negativo, il dispositivo non è riuscito ad avviare la scena e non è necessario chiamare IDirect3DDevice9::EndScene. Infatti, le chiamate a
IDirect3DDevice9::EndScene avrà esito negativo se l'errore IDirect3DDevice9::BeginScene precedente non riesce. Questo vale per qualsiasi applicazione che crea più catene di scambio.
Deve essere presente al massimo una coppia IDirect3DDevice9::BeginScene/IDirect3DDevice9::EndScene tra qualsiasi chiamata successiva a presente ( IDirect3DDevice9::P resent o IDirect3DSwapChain9::P resent). IDirect3DDevice9::BeginScene deve essere chiamato una volta prima dell'esecuzione di qualsiasi rendering e IDirect3DDevice9::EndScene deve essere chiamato una volta dopo che tutto il rendering per un frame è stato inviato al runtime. Per abilitare il parallelismo massimo tra la CPU e l'acceleratore di grafica, è vantaggioso chiamare IDirect3DDevice9::EndScene il prima possibile di chiamare presente.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | d3d9.h (include D3D9.h) |
| Libreria | D3D9.lib |