IDirect3DDevice9::EndScene-Methode (d3d9helper.h)

  • Artikel

Beendet eine Szene, die durch Aufrufen von IDirect3DDevice9::BeginScene begonnen wurde.

Syntax

HRESULT EndScene();

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird der Rückgabewert D3D_OK. Die -Methode schlägt mit D3DERR_INVALIDCALL fehl, wenn IDirect3DDevice9::BeginScene aufgerufen wird, während bereits in einem IDirect3DDevice9::BeginScene/IDirect3DDevice9::EndScene-Paar aufgerufen wird. Dies geschieht nur, wenn IDirect3DDevice9::BeginScene zweimal aufgerufen wird, ohne zuerst IDirect3DDevice9::EndScene aufzurufen.

Hinweise

Wenn diese Methode erfolgreich ist, wurde die Szene zum Rendern durch den Treiber in die Warteschlange eingereiht. Dies ist keine synchrone Methode, sodass das Rendern der Szene nicht garantiert ist, wenn diese Methode zurückgegeben wird.

Anwendungen müssen IDirect3DDevice9::BeginScene vor dem Rendern aufrufen und IDirect3DDevice9::EndScene aufrufen, wenn das Rendering abgeschlossen ist und bevor IDirect3DDevice9::BeginScene erneut aufgerufen wird.

Wenn IDirect3DDevice9::BeginScene fehlschlägt, konnte das Gerät die Szene nicht starten, und IDirect3DDevice9::EndScene muss nicht aufgerufen werden. Tatsächlich schlagen Aufrufe von IDirect3DDevice9::EndScene fehl, wenn die vorherige IDirect3DDevice9::BeginScene fehlgeschlagen ist. Dies gilt für jede Anwendung, die mehrere Swapchains erstellt.

Es sollte höchstens ein IDirect3DDevice9::BeginScene/IDirect3DDevice9::EndScene-Paar zwischen allen aufeinander folgenden Aufrufen von present (entweder IDirect3DDevice9::P resent oder IDirect3DSwapChain9::P resent) vorhanden sein. IDirect3DDevice9::BeginScene sollte einmal aufgerufen werden, bevor ein Rendering ausgeführt wird, und IDirect3DDevice9::EndScene sollte einmal aufgerufen werden, nachdem alle Renderings für einen Frame an die Runtime übermittelt wurden. Um eine maximale Parallelität zwischen der CPU und dem Grafikbeschleuniger zu ermöglichen, ist es vorteilhaft, IDirect3DDevice9::EndScene so weit wie möglich vor dem Aufrufen von present aufzurufen.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile d3d9helper.h (include D3D9.h)
Bibliothek D3D9.lib

Weitere Informationen

IDirect3DDevice9