Método IDirect3DDevice9::BeginScene (d3d9.h)

  • Artículo

Comienza una escena.

Sintaxis

HRESULT BeginScene();

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

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án 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 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. Varios pares IDirect3DDevice9::BeginScene/IDirect3DDevice9::EndScene entre llamadas que se van a presentar son legales, pero tener más de un par puede provocar un impacto en el rendimiento. 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

Consulte también

IDirect3DDevice9