Metodo IDirect3DDevice9::EndScene (d3d9.h)

  • Articolo

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

Vedi anche

IDirect3DDevice9