Texture.LockRectangle (Método) (Int32, Rectangle, LockFlags, Int32%)

Artículo
11/26/2008

Actualización: noviembre 2007

Bloquea un rectángulo en un recurso de textura.

Espacio de nombres: Microsoft.WindowsMobile.DirectX.Direct3D
Ensamblado: Microsoft.WindowsMobile.DirectX (en Microsoft.WindowsMobile.DirectX.dll)

Sintaxis

'Declaración
Public Function LockRectangle ( _
    level As Integer, _
    rect As Rectangle, _
    flags As LockFlags, _
    <OutAttribute> ByRef pitch As Integer _
) As GraphicsStream
'Uso
Dim instance As Texture
Dim level As Integer
Dim rect As Rectangle
Dim flags As LockFlags
Dim pitch As Integer
Dim returnValue As GraphicsStream

returnValue = instance.LockRectangle(level, _
    rect, flags, pitch)

public GraphicsStream LockRectangle(
    int level,
    Rectangle rect,
    LockFlags flags,
    out int pitch
)

public:
GraphicsStream^ LockRectangle(
    int level, 
    Rectangle rect, 
    LockFlags flags, 
    [OutAttribute] int% pitch
)

public function LockRectangle(
    level : int, 
    rect : Rectangle, 
    flags : LockFlags, 
    pitch : int
) : GraphicsStream

Parámetros

level
Tipo: System.Int32
Nivel minmap del recurso de textura que se va a bloquear.

rect
Tipo: System.Drawing.Rectangle
Rectangle que se va a bloquear. Para expandir la región obsoleta de manera que abarque toda la textura, omita este parámetro.

flags
Tipo: Microsoft.WindowsMobile.DirectX.Direct3D.LockFlags
Cero o más valores LockFlags que describen el tipo de bloqueo que se va a realizar. Para este método, los indicadores válidos son Discard, NoDirtyUpdate y ReadOnly.

pitch
Tipo: System.Int32%
Paso de los datos que se devuelven.

Valor devuelto

Tipo: Microsoft.WindowsMobile.DirectX.GraphicsStream
GraphicsStream que describe la región bloqueada.

Comentarios

Las texturas creadas en memoria de vídeo son bloqueables cuando se crean especificando Dynamic para Usage.

Por motivos de rendimiento, las regiones obsoletas sólo se registran para el nivel 0 de una textura. Las regiones obsoletas se registran automáticamente cuando LockRectangle no reconoce que se pueden bloquear.

Permisos

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.

Plataformas

Windows CE, Windows Mobile para Smartphone, Windows Mobile para Pocket PC

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.