DirectX SDK

Direct3DDevice7.CaptureStateBlock

The Direct3DDevice7.CaptureStateBlock method updates the values within an existing state block to the values currently set for the device.

object.CaptureStateBlock( _ 
    blockHandle As Long)

Parameters

object
Object expression that resolves to a Direct3DDevice7 object.
blockHandle
Handle to the state block into which the current device state will be captured.

Error Codes

If the method fails, an error is raised and Err.Number may be set to one of the following error codes:

D3DERR_INBEGINSTATEBLOCK
D3DERR_INOVERLAYSTATEBLOCK

Remarks

This method captures updated values for states within an existing state block. It does not capture the entire state of the device. For more information, see Capturing State Blocks.

See Also

Direct3DDevice7.ApplyStateBlock, Direct3DDevice7.BeginStateBlock, Direct3DDevice7.CreateStateBlock, Direct3DDevice7.EndStateBlock, Direct3DDevice7.DeleteStateBlock, State Blocks