Metodo IDirect3DDevice9::BeginStateBlock (d3d9helper.h)

Segnala a Direct3D di iniziare a registrare un blocco di stato del dispositivo.

Sintassi

HRESULT BeginStateBlock();

Valore restituito

Tipo: HRESULT

Se il metodo ha esito positivo, il valore restituito viene D3D_OK. Se il metodo ha esito negativo, il valore restituito può essere uno dei seguenti: D3DERR_INVALIDCALL, E_OUTOFMEMORY.

Commenti

Le applicazioni possono garantire che tutti gli stati registrati siano validi chiamando il metodo IDirect3DDevice9::ValidateDevice prima di chiamare questo metodo.

I metodi seguenti possono essere registrati in un blocco di stato, dopo aver chiamato IDirect3DDevice9::BeginStateBlock e prima di IDirect3DDevice9::EndStateBlock.

• IDirect3DDevice9::LightEnable
• IDirect3DDevice9::SetClipPlane
• IDirect3DDevice9::SetCurrentTexturePalette
• IDirect3DDevice9::SetFVF
• IDirect3DDevice9::SetIndices
• IDirect3DDevice9::SetLight
• IDirect3DDevice9::SetMaterial
• IDirect3DDevice9::SetNPatchMode
• IDirect3DDevice9::SetPixelShader
• IDirect3DDevice9::SetPixelShaderConstantB
• IDirect3DDevice9::SetPixelShaderConstantF
• IDirect3DDevice9::SetPixelShaderConstantI
• IDirect3DDevice9::SetRenderState
• IDirect3DDevice9::SetSamplerState
• IDirect3DDevice9::SetScissorRect
• IDirect3DDevice9::SetStreamSource
• IDirect3DDevice9::SetStreamSourceFreq
• IDirect3DDevice9::SetTexture
• IDirect3DDevice9::SetTextureStageState
• IDirect3DDevice9::SetTransform
• IDirect3DDevice9::SetViewport
• IDirect3DDevice9::SetVertexDeclaration
• IDirect3DDevice9::SetVertexShader
• IDirect3DDevice9::SetVertexShaderConstantB
• IDirect3DDevice9::SetVertexShaderConstantF
• IDirect3DDevice9::SetVertexShaderConstantI

L'ordinamento delle modifiche dello stato in un blocco di stato non è garantito. Se lo stesso stato viene specificato più volte in un blocco di stato, viene usato solo l'ultimo valore.

Requisiti

Piattaforma di destinazione	Windows
Intestazione	d3d9helper.h (include D3D9.h)
Libreria	D3D9.lib

Vedi anche

IDirect3DDevice9

IDirect3DDevice9::CreateStateBlock

IDirect3DDevice9::EndStateBlock