Microsoft DirectX 9.0 SDK Update (October 2004)

VolumeTexture.LockBox Method

Language:

Note: This documentation is preliminary and is subject to change.

Locks a box on a volume texture resource.

Definition

Visual Basic .NET Public Function LockBox( _
    ByVal level As Integer, _
    ByVal box As Box, _
    ByVal flags As LockFlags _
) As GraphicsStream
C# public GraphicsStream LockBox(
    int level,
    Box box,
    LockFlags flags
);
Managed C++ public: GraphicsStream* LockBox(
    int level,
    Box box,
    LockFlags flags
);
JScript .NET public function LockBox(
    level : int,
    box : Box,
    flags : LockFlags
) : GraphicsStream;

Parameters

level System.Int32. Value that specifies a level of the texture resource to lock.
box Microsoft.DirectX.Direct3D.Box. A Box structure that indicates the region to lock. Omitting this parameter locks the entire volume level.
flags Microsoft.DirectX.Direct3D.LockFlags. Zero or more locking flags that describe the type of lock to perform. For this method, the valid flags are Discard, NoDirtyUpdate, NoSystemLock, and ReadOnly. For a description of the flags, see LockFlags.

Return Value

Microsoft.DirectX.GraphicsStream . A GraphicsStream object that describes the locked region.

Remarks

For performance reasons, dirty regions are recorded only for level 0 of a texture. Dirty regions are automatically recorded when Texture.LockRectangle is called without NoDirtyUpdate or ReadOnly. For more information, see Device.UpdateTexture.

Exceptions
InvalidCallException The method call is invalid. For example, a method's parameter might contain an invalid value.

See Also


© 2004 Microsoft Corporation. All rights reserved. Terms of use.

Feedback? Please provide us with your comments on this topic.
For more help, visit the DirectX Developer Center