Microsoft DirectX 9.0

IDirect3DDevice9::BeginStateBlock Method

Signals Microsoft?Direct3D?to begin recording a device-state block.


HRESULT BeginStateBlock(VOID);

Return Value

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_INVALIDCALLThe method call is invalid. For example, a method's parameter may have an invalid value.
E_OUTOFMEMORYDirect3D could not allocate sufficient memory to complete the call.


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

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

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.

See Also

IDirect3DDevice9::EndStateBlock, IDirect3DDevice9::CreateStateBlock

© 2002 Microsoft Corporation. All rights reserved.