Méthode IDirect3DDevice9 ::EndScene (d3d9helper.h)

  • Article

Termine une scène qui a été commencée en appelant IDirect3DDevice9 ::BeginScene.

Syntaxe

HRESULT EndScene();

Valeur de retour

Type : HRESULT

Si la méthode réussit, la valeur de retour est D3D_OK. La méthode échoue avec D3DERR_INVALIDCALL si IDirect3DDevice9 ::BeginScene est appelé alors que déjà dans une paire IDirect3DDevice9 ::BeginScene/IDirect3DDevice9 ::EndScene . Cela se produit uniquement lorsque IDirect3DDevice9 ::BeginScene est appelé deux fois sans appeler IDirect3DDevice9 ::EndScene.

Remarques

Lorsque cette méthode réussit, la scène a été mise en file d’attente pour le rendu par le pilote. Il ne s’agit pas d’une méthode synchrone, de sorte que le rendu de la scène n’est pas garanti lorsque cette méthode est retournée.

Les applications doivent appeler IDirect3DDevice9 ::BeginScene avant d’effectuer un rendu et doivent appeler IDirect3DDevice9 ::EndScene une fois le rendu terminé et avant d’appeler À nouveau IDirect3DDevice9 ::BeginScene .

Si IDirect3DDevice9 ::BeginScene échoue, l’appareil n’a pas pu démarrer la scène et il n’est pas nécessaire d’appeler IDirect3DDevice9 ::EndScene. En fait, les appels à IDirect3DDevice9 ::EndScene échouent si le IDirect3DDevice9 ::BeginScene précédent a échoué. Cela s’applique à toute application qui crée plusieurs chaînes d’échange.

Il doit y avoir au maximum une paire IDirect3DDevice9 ::BeginScene/IDirect3DDevice9 ::EndScene entre tous les appels successifs à présenter ( IDirect3DDevice9 ::P resent ou IDirect3DSwapChain9 ::P resent). IDirect3DDevice9 ::BeginScene doit être appelé une fois avant qu’un rendu ne soit effectué, et IDirect3DDevice9 ::EndScene doit être appelé une fois que le rendu d’une image a été soumis au runtime. Pour activer le parallélisme maximal entre le processeur et l’accélérateur graphique, il est avantageux d’appeler IDirect3DDevice9 ::EndScene aussi loin que possible d’appeler présent.

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête d3d9helper.h (incluez D3D9.h)
Bibliothèque D3D9.lib

Voir aussi

IDirect3DDevice9