Microsoft DirectX 9.0 SDK Update (October 2004)

Volume.LockBox Method

Language:

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

Locks a box on a volume resource.

Definition

Visual Basic .NET Public Function LockBox( _
    ByVal flags As LockFlags, _
    ByRef lockedVolume As LockedBox _
) As GraphicsStream
C# public GraphicsStream LockBox(
    LockFlags flags,
    out LockedBox lockedVolume
);
Managed C++ public: GraphicsStream* LockBox(
    LockFlags flags,
    LockedBox *lockedVolume
);
JScript .NET public function LockBox(
    flags : LockFlags,
    lockedVolume : LockedBox
) : GraphicsStream;

Parameters

flags Microsoft.DirectX.Direct3D.LockFlags. Combination of zero or more LockFlags that describe the type of lock to perform. See Remarks.
lockedVolume Microsoft.DirectX.Direct3D.LockedBox. A LockedBox object that describes the locked region.

Return Value

Microsoft.DirectX.GraphicsStream . A GraphicsStream that represents the locked box region.

Remarks

The valid lock flags for this method are:

For performance reasons, dirty regions are recorded only for level zero of a texture. Dirty regions are automatically recorded when Volume.LockBox is called without LockFlags.NoDirtyUpdate or LockFlags.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.


© 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