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

Sinaliza o Direct3D para começar a gravar um bloco de estado do dispositivo.

Sintaxe

HRESULT BeginStateBlock();

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, o valor retornado será D3D_OK. Se o método falhar, o valor retornado poderá ser um dos seguintes: D3DERR_INVALIDCALL, E_OUTOFMEMORY.

Comentários

Os aplicativos podem garantir que todos os estados registrados sejam válidos chamando o método IDirect3DDevice9::ValidateDevice antes de chamar esse método.

Os métodos a seguir podem ser registrados em um bloco de estado, depois de chamar IDirect3DDevice9::BeginStateBlock e antes de 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

A ordenação de alterações de estado em um bloco de estado não é garantida. Se o mesmo estado for especificado várias vezes em um bloco de estado, somente o último valor será usado.

Requisitos

Plataforma de Destino	Windows
Cabeçalho	d3d9.h (inclua D3D9.h)
Biblioteca	D3D9.lib

Confira também

IDirect3DDevice9

IDirect3DDevice9::CreateStateBlock

IDirect3DDevice9::EndStateBlock