Platform SDK: DirectX

IDirect3DDevice7::ApplyStateBlock

The IDirect3DDevice7::ApplyStateBlock method applies an existing device-state block to the rendering device.

HRESULT ApplyStateBlock( 
  DWORD dwBlockHandle 
); 

Parameters

dwBlockHandle
Handle to the device state block to be executed, as returned by a previous call to the IDirect3DDevice7::EndStateBlock method.

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_INBEGINSTATEBLOCK
D3DERR_INVALIDSTATEBLOCK

Remarks

Applications cannot apply a device state block while recording another block.

This method was introduced with the IDirect3DDevice7 interface.

As with all operations that affect the state of the rendering device, it is recommend that you apply state blocks during scene rendering—that is, after calling the IDirect3DDevice7::BeginScene method and before calling IDirect3DDevice7::EndScene.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Version: Requires DirectX 7.0.
  Header: Declared in d3d.h.

See Also

IDirect3DDevice7::BeginStateBlock, IDirect3DDevice7::EndStateBlock, IDirect3DDevice7::CaptureStateBlock, IDirect3DDevice7::CreateStateBlock, IDirect3DDevice7::DeleteStateBlock, State Blocks