IDirect3DDevice8::ApplyStateBlock

This method applies an existing device-state block to the rendering device.

HRESULT ApplyStateBlock(
  DWORD Token
);

Parameters

• Token
  [in] Handle to the device-state block to execute, as returned by a previous call to the IDirect3DDevice8::EndStateBlock method.

Return Values

If the method succeeds, the return value is D3D_OK.

If the method fails, the return value can be D3DERR_INVALIDCALL.

Remarks

The value 0xFFFFFFFF is an invalid state block handle.

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

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

Requirements

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

See Also

IDirect3DDevice8::BeginStateBlock | IDirect3DDevice8::EndStateBlock | IDirect3DDevice8::CaptureStateBlock | IDirect3DDevice8::CreateStateBlock | IDirect3DDevice8::DeleteStateBlock | IDirect3DDevice8

 Last updated on Thursday, April 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.