Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
BeginStateBlock
Collapse the table of content
Expand the table of content

IDirect3DDevice9::BeginStateBlock method

Signals Direct3D to begin recording a device-state block.

Syntax


HRESULT BeginStateBlock();

Parameters

This method has no parameters.

Return value

Type: HRESULT

If the method succeeds, the return value is D3D_OK. If the method fails, the return value can be one of the following: D3DERR_INVALIDCALL, E_OUTOFMEMORY.

Remarks

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.

Requirements

Header

D3D9.h

Library

D3D9.lib

See also

IDirect3DDevice9
IDirect3DDevice9::EndStateBlock
IDirect3DDevice9::CreateStateBlock

 

 

Community Additions

ADD
Show:
© 2015 Microsoft