VertexBuffer.Lock Method (Int32, LockFlags)

Article
10/15/2009

[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]

Locks a range of vertex data and returns the vertex buffer memory.

Namespace: Microsoft.WindowsMobile.DirectX.Direct3D
Assembly: Microsoft.WindowsMobile.DirectX (in Microsoft.WindowsMobile.DirectX.dll)

Syntax

'Declaration
Public Function Lock ( _
    offsetToLock As Integer, _
    flags As LockFlags _
) As Array
'Usage
Dim instance As VertexBuffer
Dim offsetToLock As Integer
Dim flags As LockFlags
Dim returnValue As Array

returnValue = instance.Lock(offsetToLock, _
    flags)

public Array Lock(
    int offsetToLock,
    LockFlags flags
)

public:
Array^ Lock(
    int offsetToLock, 
    LockFlags flags
)

member Lock : 
        offsetToLock:int * 
        flags:LockFlags -> Array

Parameters

offsetToLock
Type: System.Int32
Offset into the vertex data to lock, in bytes. To lock the entire vertex buffer, specify 0 for both sizeToLock and offsetToLock.

flags
Type: Microsoft.WindowsMobile.DirectX.Direct3D.LockFlags
One or more LockFlags values that describe the type of lock to perform. The valid flags for this method are NoDirtyUpdate, NoOverwrite, and ReadOnly.

Return Value

Type: System.Array
An Array that represents the locked vertex buffer.

Exceptions

Exception	Condition
InvalidCallException	The method call is invalid. For example, a method's parameter may contain an invalid value.

Remarks

Note that the .NET Compact Framework does not support multiple lock calls.

When using this method to retrieve an array from a resource that was not created with a type, always use the overload that accepts a type.

The Discard and NoOverwrite values for LockFlags are valid only on buffers created with Dynamic specified for Usage.

.NET Framework Security

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

Platforms

Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Compact Framework

Supported in: 3.5, 2.0

Partager via