IDirect3DDevice8::BeginStateBlock

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.

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::SetPixelShader
• IDirect3DDevice8::SetPixelShaderConstant
• IDirect3DDevice8::SetRenderState
• IDirect3DDevice8::SetStreamSource
• IDirect3DDevice8::SetTexture
• IDirect3DDevice8::SetTextureStageState
• IDirect3DDevice8::SetTransform
• IDirect3DDevice8::SetViewport
• IDirect3DDevice8::SetVertexShader
• IDirect3DDevice8::SetVertexShaderConstant

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

  Header: Declared in D3d8.h.
  Import Library: Use D3d8.lib.

See Also

IDirect3DDevice8::ApplyStateBlock, IDirect3DDevice8::EndStateBlock, IDirect3DDevice8::CaptureStateBlock, IDirect3DDevice8::CreateStateBlock, IDirect3DDevice8::DeleteStateBlock