Direct3DCubeTexture8.LockRect

Locks a rectangle on a cube texture resource.

object.LockRect( _ 
    FaceType As CONST_D3DCUBEMAP_FACES, _ 
    Level As Long, _ 
    LockedRect As D3DLOCKED_RECT, _ 
    Rect As Any, _ 
    Flags As Long)

Parts

object

Object expression that resolves to a Direct3DCubeTexture8 object.

FaceType

Member of the CONST_D3DCUBEMAP_FACES enumeration, identifying a cube map face.

Level

Specifies a level of a mipmapped cube texture.

LockedRect

A D3DLOCKED_RECT type, describing the region to lock.

Rect

Rectangle to lock. Specified by a RECT type, or ByVal 0 to expand the dirty region to cover the entire texture.

Flags

A combination of zero or more valid locking flags defined by the CONST_D3DLOCKFLAGS enumeration, describing the type of lock to perform.

Error Codes

If the method fails, an error is raised and Err.Number can be set to D3DERR_INVALIDCALL.

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

Remarks

For performance reasons, dirty regions are only recorded for level zero of a texture. Dirty regions are automatically recorded when LockRect is called without D3DLOCK_NO_DIRTY_UPDATE or D3DLOCK_READONLY. See Direct3DDevice8.UpdateTexture for more information.

A multisample backbuffer cannot be locked.

See Also

Direct3DCubeTexture8.AddDirtyRect, Direct3DCubeTexture8.GetLevelDesc, Direct3DCubeTexture8.UnlockRect