IDirect3DDevice8::BeginStateBlock

This method signals Microsoft® Direct3D® to begin recording a device-state block.

HRESULT BeginStateBlock();

Parameters

None.

Return Values

If the method succeeds, the return value is D3D_OK.

If the method fails, the return value can be one of the following values:

• D3DERR_INVALIDCALL
• E_OUTOFMEMORY

Remarks

Applications can ensure that all recorded states are valid by calling the IDirect3DDevice8::ValidateDevice method prior to calling this method.

The following methods can be recorded in a state block, after calling BeginStateBlock and before IDirect3DDevice8::EndStateBlock.

• IDirect3DDevice8::LightEnable
• IDirect3DDevice8::SetClipPlane
• IDirect3DDevice8::SetIndices
• IDirect3DDevice8::SetLight
• IDirect3DDevice8::SetMaterial
• IDirect3DDevice8::SetRenderState
• IDirect3DDevice8::SetStreamSource
• IDirect3DDevice8::SetTexture
• IDirect3DDevice8::SetTextureStageState
• IDirect3DDevice8::SetTransform
• IDirect3DDevice8::SetViewport
• IDirect3DDevice8::SetVertexShader

The ordering of state changes in a state block is not guaranteed. If the same state is specified multiple times in a state block, only the last value is used.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: D3d8.h.
Link Library: D3d8.lib.

See Also

IDirect3DDevice8::ApplyStateBlock | IDirect3DDevice8::EndStateBlock | IDirect3DDevice8::CaptureStateBlock | IDirect3DDevice8::CreateStateBlock | IDirect3DDevice8::DeleteStateBlock | IDirect3DDevice8::ValidateDevice | IDirect3DDevice8

 Last updated on Thursday, April 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.