Método IDirect3DDevice9::EndScene (d3d9.h)
Finaliza una escena que se inició llamando a IDirect3DDevice9::BeginScene.
Sintaxis
HRESULT EndScene();
Valor devuelto
Tipo: HRESULT
Si el método se ejecuta correctamente, el valor devuelto es D3D_OK. Se producirá un error en el método con D3DERR_INVALIDCALL si se llama a IDirect3DDevice9::BeginScene mientras ya está en un par IDirect3DDevice9::BeginScene/IDirect3DDevice9::EndScene . Esto sucede solo cuando se llama a IDirect3DDevice9::BeginScene dos veces sin llamar primero a IDirect3DDevice9::EndScene.
Comentarios
Cuando este método se realiza correctamente, el controlador ha puesto en cola la escena para la representación. Este no es un método sincrónico, por lo que no se garantiza que la escena haya completado la representación cuando este método vuelva.
Las aplicaciones deben llamar a IDirect3DDevice9::BeginScene antes de realizar cualquier representación y deben llamar a IDirect3DDevice9::EndScene cuando se complete la representación y antes de llamar a IDirect3DDevice9::BeginScene de nuevo.
Si se produce un error en IDirect3DDevice9::BeginScene , el dispositivo no pudo iniciar la escena y no es necesario llamar a IDirect3DDevice9::EndScene. De hecho, las llamadas a
IDirect3DDevice9::EndScene producirá un error si se produjo un error en el IDirect3DDevice9::BeginScene anterior. Esto se aplica a cualquier aplicación que cree varias cadenas de intercambio.
Debe haber como máximo un par IDirect3DDevice9::BeginScene/IDirect3DDevice9::EndScene entre las llamadas sucesivas que se van a presentar (ya sea IDirect3DDevice9::P resent o IDirect3DSwapChain9::P resent). Se debe llamar a IDirect3DDevice9::BeginScene una vez antes de realizar cualquier representación y se debe llamar a IDirect3DDevice9::EndScene una vez después de que se haya enviado toda la representación de un fotograma al tiempo de ejecución. Para habilitar el paralelismo máximo entre la CPU y el acelerador de gráficos, es ventajoso llamar a IDirect3DDevice9::EndScene lo antes posible de llamar a .
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | d3d9.h (incluya D3D9.h) |
| Library | D3D9.lib |