IDirect3DDevice9::BeginStateBlock, méthode (d3d9helper.h)

Indique à Direct3D de commencer l’enregistrement d’un bloc d’état de l’appareil.

Syntaxe

HRESULT BeginStateBlock();

Valeur de retour

Type : HRESULT

Si la méthode réussit, la valeur de retour est D3D_OK. Si la méthode échoue, la valeur de retour peut être l’une des suivantes : D3DERR_INVALIDCALL, E_OUTOFMEMORY.

Notes

Les applications peuvent s’assurer que tous les états enregistrés sont valides en appelant la méthode IDirect3DDevice9::ValidateDevice avant d’appeler cette méthode.

Les méthodes suivantes peuvent être enregistrées dans un bloc d’état, après avoir appelé IDirect3DDevice9::BeginStateBlock et avant 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’ordre des changements d’état dans un bloc d’état n’est pas garanti. Si le même état est spécifié plusieurs fois dans un bloc d’état, seule la dernière valeur est utilisée.

Spécifications

Plateforme cible	Windows
En-tête	d3d9helper.h (incluez D3D9.h)
Bibliothèque	D3D9.lib

Voir aussi

IDirect3DDevice9

IDirect3DDevice9::CreateStateBlock

IDirect3DDevice9::EndStateBlock