IDirect3DDevice8::EndStateBlock

Signals Microsoft® Direct3D® to stop recording a device-state block and retrieve a handle to the state block.

HRESULT EndStateBlock(
  DWORD* pToken
);

Parameters

pToken

[out, retval] Pointer to a variable to fill with the handle to the completed device-state block. This value is used with the IDirect3DDevice8::ApplyStateBlock and IDirect3DDevice8::DeleteStateBlock methods.

Return Values

If the method succeeds, the return value is D3D_OK.

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

Requirements

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

Remarks

The value 0xFFFFFFFF is an invalid state block handle.

See Also

IDirect3DDevice8::ApplyStateBlock, IDirect3DDevice8::BeginStateBlock, IDirect3DDevice8::CaptureStateBlock, IDirect3DDevice8::CreateStateBlock, IDirect3DDevice8::DeleteStateBlock