Metodo IDirect3DDevice9::BeginScene (d3d9.h)

  • Articolo

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 d3d9.h (includere D3D9.h)
Libreria D3D9.lib

Vedi anche

IDirect3DDevice9