Método IDirect3DDevice9::BeginScene (d3d9.h)
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 |