Metodo IDirect3DDevice9::BeginScene (d3d9helper.h)
Inizia una scena.
Sintassi
HRESULT BeginScene();
Valore restituito
Tipo: HRESULT
Se il metodo ha esito positivo, il valore restituito è D3D_OK. Il metodo avrà esito negativo con D3DERR_INVALIDCALL se viene chiamato IDirect3DDevice9::BeginScene mentre è già presente in una coppia IDirect3DDevice9::BeginScene IDirect3DDevice9::EndScene/. Ciò accade solo quando IDirect3DDevice9::BeginScene viene chiamato due volte senza prima chiamare IDirect3DDevice9::EndScene.
Commenti
Le applicazioni devono chiamare IDirect3DDevice9::BeginScene prima di eseguire qualsiasi rendering e devono chiamare nuovamente IDirect3DDevice9::EndScene al termine del rendering e prima di chiamare nuovamente IDirect3DDevice9::BeginScene .
Se IDirect3DDevice9::BeginScene ha esito negativo, il dispositivo non è riuscito a iniziare la scena e non è necessario chiamare IDirect3DDevice9::EndScene. In effetti, le chiamate a IDirect3DDevice9::EndScene avranno esito negativo se il precedente IDirect3DDevice9::BeginScene non è riuscito. Questo vale per qualsiasi applicazione che crea più catene di scambio.
Dovrebbe esserci una coppia IDirect3DDevice9::BeginScene IDirect3DDevice9::EndScenetra qualsiasi chiamata successiva a presente (IDirect3DDevice9::P resent o IDirect3DSwapChain9::P resent)./ IDirect3DDevice9::BeginScene deve essere chiamato una volta prima dell'esecuzione di qualsiasi rendering e IDirect3DDevice9::EndScene deve essere chiamato una volta dopo l'invio di tutti i rendering per un frame al runtime. Più coppie IDirect3DDevice9::BeginScene IDirect3DDevice9::EndScenetra le chiamate presenti sono legali, ma la presenza di più coppie potrebbe comportare un colpo di prestazioni./ Per abilitare il parallelismo massimo tra la CPU e l'acceleratore di grafica, è vantaggioso chiamare IDirect3DDevice9::EndScene quanto prima di chiamare il più possibile.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | d3d9helper.h (include D3D9.h) |
| Libreria | D3D9.lib |