Share via


LockFlags Enumeration

Defines the type of lock to perform.

This enumeration has a FlagsAttribute attribute that allows a bitwise combination of its member values.

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

Syntax

'Declaration
<FlagsAttribute> _
Public Enumeration LockFlags
'Usage
Dim instance As LockFlags
[FlagsAttribute] 
public enum LockFlags
[FlagsAttribute] 
public enum class LockFlags
/** @attribute FlagsAttribute() */ 
public enum LockFlags
FlagsAttribute 
public enum LockFlags

Members

  Member name Description
Supported by the .NET Compact Framework Discard The application overwrites every location within the region being locked, using a write-only operation. This is a valid option when using dynamic textures, dynamic vertex buffers, and dynamic index buffers.  

For vertex and index buffers, the application discards the entire buffer. A pointer to a new memory area is returned so that the direct memory access (DMA) and rendering from the previous area do not stall. For textures, the application overwrites every location within the region being locked, using a write-only operation.

Supported by the .NET Compact Framework NoDirtyUpdate By default, a lock on a resource adds a dirty region to that resource. This flag prevents any changes to the dirty state of the resource. Applications should use this flag when they have additional information about the set of regions changed during the lock operation. 
Supported by the .NET Compact Framework None The application may read and write to and from the buffer. 
Supported by the .NET Compact Framework NoOverwrite The application is guaranteed not to overwrite any data in the vertex and index buffers. This flag allows the driver to return immediately and continue rendering, using this vertex buffer. If the flag is not used, the driver must finish rendering before returning from locking. 
Supported by the .NET Compact Framework ReadOnly The application does not write to the buffer. This flag enables resources stored in non-native formats to save the recompression step when unlocking. 

Platforms

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

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

Version Information

.NET Compact Framework

Supported in: 2.0

See Also

Reference

Microsoft.WindowsMobile.DirectX.Direct3D Namespace

Other Resources

Mobile Direct3D Programming