IDirect3DDevice9::BeginStateBlock-Methode (d3d9helper.h)

Signalisiert Direct3D, mit der Aufzeichnung eines Gerätezustandsblocks zu beginnen.

Syntax

HRESULT BeginStateBlock();

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird der Rückgabewert D3D_OK. Wenn die Methode fehlschlägt, kann der Rückgabewert einer der folgenden Sein: D3DERR_INVALIDCALL, E_OUTOFMEMORY.

Hinweise

Anwendungen können sicherstellen, dass alle aufgezeichneten Zustände gültig sind, indem sie vor dem Aufrufen dieser Methode die IDirect3DDevice9::ValidateDevice-Methode aufrufen.

Die folgenden Methoden können in einem Zustandsblock aufgezeichnet werden, nachdem IDirect3DDevice9::BeginStateBlock und vor IDirect3DDevice9::EndStateBlock aufgerufen wurden.

• 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

Die Reihenfolge von Zustandsänderungen in einem Zustandsblock ist nicht garantiert. Wenn derselbe Zustand mehrmals in einem Zustandsblock angegeben wird, wird nur der letzte Wert verwendet.

Anforderungen

Zielplattform	Windows
Kopfzeile	d3d9helper.h (include D3D9.h)
Bibliothek	D3D9.lib

Weitere Informationen

IDirect3DDevice9

IDirect3DDevice9::CreateStateBlock

IDirect3DDevice9::EndStateBlock