Microsoft DirectX 8.1 (Visual Basic)

Direct3DDevice8.DeleteStateBlock

Deletes a previously recorded device-state block.

object.DeleteStateBlock( _ 
    Token As Long)

Parts

object
Object expression that resolves to a Direct3DDevice8 object.
Token
Handle to the device-state block to delete, as returned by a previous call to the Direct3DDevice8.EndStateBlock method.

Error Codes

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

D3DERR_INVALIDCALL
D3DERR_OUTOFVIDEOMEMORY

Err.Number may be set to D3DERR_INVALIDCALL to indicate that the Token parameter is invalid or a macro is currently being recorded.

For information on trapping errors, see the Microsoft® Visual Basic® Error Handling topic.

Remarks

The value &hFFFFFFFF& is an invalid state block handle.

Applications cannot delete a device-state block while another is being recorded

See Also

Direct3DDevice8.ApplyStateBlock, Direct3DDevice8.BeginStateBlock, Direct3DDevice8.CaptureStateBlock, Direct3DDevice8.CreateStateBlock, Direct3DDevice8.EndStateBlock