IDirect3DDevice9::EndScene-Methode (d3d9.h)
Beendet eine Szene, die durch Aufrufen von IDirect3DDevice9::BeginScene gestartet 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 gestellt. Dies ist keine synchrone Methode, sodass nicht garantiert wird, dass die Szene das Rendering abgeschlossen hat, wenn diese Methode zurückgibt.
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 es ist nicht erforderlich, IDirect3DDevice9::EndScene aufzurufen. In der Tat, Aufrufe an
IDirect3DDevice9::EndScene schlägt fehl, wenn das 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 vorhanden sein (entweder IDirect3DDevice9::P resent oder IDirect3DSwapChain9::P resent). IDirect3DDevice9::BeginScene sollte einmal aufgerufen werden, bevor ein Rendering ausgeführt wird, und IDirect3DDevice9::EndScene sollte einmal aufgerufen werden, nachdem das gesamte Rendering für einen Frame an die Runtime übermittelt wurde. Um eine maximale Parallelität zwischen der CPU und dem Grafikbeschleuniger zu ermöglichen, ist es von Vorteil, IDirect3DDevice9::EndScene so weit vor dem Aufrufen von present so weit wie möglich aufzurufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | d3d9.h (einschließlich D3D9.h) |
| Bibliothek | D3D9.lib |