Marshal.ReadIntPtr Método

  • Referencia

Definición

Espacio de nombres:
System.Runtime.InteropServices
Ensamblado:
System.Runtime.InteropServices.dll
Ensamblado:
mscorlib.dll
Ensamblado:
netstandard.dll

Lee de la memoria no administrada un valor de tipo entero cuyo tamaño en bytes es propio del procesador nativo. Se admite la lectura desde ubicaciones de memoria desalineadas.

Sobrecargas

ReadIntPtr(IntPtr, Int32)

Lee de la memoria no administrada un valor de tipo entero cuyo tamaño en bytes es propio del procesador nativo en un desplazamiento dado.
ReadIntPtr(Object, Int32)
Obsoletos.

Lee de la memoria no administrada un valor de tipo entero cuyo tamaño en bytes es propio del procesador nativo.
ReadIntPtr(IntPtr)

Lee de la memoria no administrada un entero cuyo tamaño es propio del procesador nativo.

ReadIntPtr(IntPtr, Int32)

Source:
Marshal.cs
Source:
Marshal.cs
Source:
Marshal.cs

Lee de la memoria no administrada un valor de tipo entero cuyo tamaño en bytes es propio del procesador nativo en un desplazamiento dado.

public:
 static IntPtr ReadIntPtr(IntPtr ptr, int ofs);
[System.Security.SecurityCritical]
public static IntPtr ReadIntPtr (IntPtr ptr, int ofs);
public static IntPtr ReadIntPtr (IntPtr ptr, int ofs);
[<System.Security.SecurityCritical>]
static member ReadIntPtr : nativeint * int -> nativeint
static member ReadIntPtr : nativeint * int -> nativeint
Public Shared Function ReadIntPtr (ptr As IntPtr, ofs As Integer) As IntPtr

Parámetros

ptr
IntPtr

nativeint

Dirección base en la memoria no administrada desde la que se va a leer.

ofs
Int32

Desplazamiento de bytes adicional, que se agrega al parámetro ptr antes de la lectura.

Devoluciones

IntPtr

nativeint

Entero leído de la memoria no administrada en el desplazamiento dado.

Atributos
SecurityCriticalAttribute

Excepciones

AccessViolationException

La dirección base (ptr) más el byte de desplazamiento (ofs) produce un valor null o una dirección no válida.

Ejemplos

En el ejemplo siguiente se muestra cómo leer y escribir en una matriz no administrada mediante los ReadIntPtr métodos y WriteIntPtr .

static void ReadWriteIntPtr()
{
    // Allocate unmanaged memory. 
    int elementSize = Marshal.SizeOf(typeof(IntPtr));
    IntPtr unmanagedArray = Marshal.AllocHGlobal(10 * elementSize);

    // Set the 10 elements of the C-style unmanagedArray
    for (int i = 0; i < 10; i++)
    {
        Marshal.WriteIntPtr(unmanagedArray, i * elementSize, ((IntPtr)(i + 1)));
    }
    Console.WriteLine("Unmanaged memory written.");

    Console.WriteLine("Reading unmanaged memory:");
    // Print the 10 elements of the C-style unmanagedArray
    for (int i = 0; i < 10; i++)
    {
        Console.WriteLine(Marshal.ReadIntPtr(unmanagedArray, i * elementSize));
    }

    Marshal.FreeHGlobal(unmanagedArray);

    Console.WriteLine("Done. Press Enter to continue.");
    Console.ReadLine();
}

Sub ReadWriteIntPtr()
    ' Allocate unmanaged memory.
    Dim elementSize As Integer = Marshal.SizeOf(GetType(IntPtr))
    Dim unmanagedArray As IntPtr = Marshal.AllocHGlobal(10 * elementSize)

    ' Set the 10 elements of the C-style unmanagedArray
    For i As Integer = 0 To 9
        Marshal.WriteIntPtr(unmanagedArray, i * elementSize, CType(i + 1, IntPtr))
    Next i
    Console.WriteLine("Unmanaged memory written.")

    Console.WriteLine("Reading unmanaged memory:")
    ' Print the 10 elements of the C-style unmanagedArray
    For i As Integer = 0 To 9
        Console.WriteLine(Marshal.ReadIntPtr(unmanagedArray, i * elementSize))
    Next i

    Marshal.FreeHGlobal(unmanagedArray)

    Console.WriteLine("Done. Press Enter to continue.")
    Console.ReadLine()
End Sub

Comentarios

ReadIntPtr permite la interacción directa con una matriz de estilo IntPtr C no administrada, lo que elimina el gasto de copiar una matriz no administrada completa (mediante Marshal.Copy) en una matriz administrada independiente antes de leer sus valores de elemento.

Se admite la lectura desde ubicaciones de memoria desalineadas.

Consulte también

Se aplica a

ReadIntPtr(Object, Int32)

Source:
Marshal.cs
Source:
Marshal.cs
Source:
Marshal.cs

Precaución

ReadIntPtr(Object, Int32) may be unavailable in future releases.

Lee de la memoria no administrada un valor de tipo entero cuyo tamaño en bytes es propio del procesador nativo.

public:
 static IntPtr ReadIntPtr(System::Object ^ ptr, int ofs);
[System.Obsolete("ReadIntPtr(Object, Int32) may be unavailable in future releases.")]
[System.Security.SecurityCritical]
public static IntPtr ReadIntPtr (object ptr, int ofs);
[System.Obsolete("ReadIntPtr(Object, Int32) may be unavailable in future releases.")]
public static IntPtr ReadIntPtr (object ptr, int ofs);
public static IntPtr ReadIntPtr (object ptr, int ofs);
[System.Security.SecurityCritical]
public static IntPtr ReadIntPtr (object ptr, int ofs);
[<System.Obsolete("ReadIntPtr(Object, Int32) may be unavailable in future releases.")>]
[<System.Security.SecurityCritical>]
static member ReadIntPtr : obj * int -> nativeint
[<System.Obsolete("ReadIntPtr(Object, Int32) may be unavailable in future releases.")>]
static member ReadIntPtr : obj * int -> nativeint
static member ReadIntPtr : obj * int -> nativeint
[<System.Security.SecurityCritical>]
static member ReadIntPtr : obj * int -> nativeint
Public Shared Function ReadIntPtr (ptr As Object, ofs As Integer) As IntPtr

Parámetros

ptr
Object

Dirección base en la memoria no administrada del objeto de origen.

ofs
Int32

Desplazamiento de bytes adicional, que se agrega al parámetro ptr antes de la lectura.

Devoluciones

IntPtr

nativeint

Entero leído de la memoria no administrada en el desplazamiento dado.

Atributos
ObsoleteAttribute SecurityCriticalAttribute

Excepciones

AccessViolationException

La dirección base (ptr) más el byte de desplazamiento (ofs) produce un valor null o una dirección no válida.

ArgumentException

ptr es un objeto ArrayWithOffset. Este método no acepta parámetros ArrayWithOffset.

Comentarios

ReadIntPtr permite la interacción directa con una matriz de estilo IntPtr C no administrada, lo que elimina el gasto de copiar una matriz no administrada completa (mediante Marshal.Copy) en una matriz administrada independiente antes de leer sus valores de elemento.

Se admite la lectura desde ubicaciones de memoria desalineadas.

Consulte también

Se aplica a

ReadIntPtr(IntPtr)

Source:
Marshal.cs
Source:
Marshal.cs
Source:
Marshal.cs

Lee de la memoria no administrada un entero cuyo tamaño es propio del procesador nativo.

public:
 static IntPtr ReadIntPtr(IntPtr ptr);
[System.Security.SecurityCritical]
public static IntPtr ReadIntPtr (IntPtr ptr);
public static IntPtr ReadIntPtr (IntPtr ptr);
[<System.Security.SecurityCritical>]
static member ReadIntPtr : nativeint -> nativeint
static member ReadIntPtr : nativeint -> nativeint
Public Shared Function ReadIntPtr (ptr As IntPtr) As IntPtr

Parámetros

ptr
IntPtr

nativeint

Dirección en la memoria no administrada desde la que se va a leer.

Devoluciones

IntPtr

nativeint

Entero leído de la memoria no administrada. Se devuelve un entero de 32 bits en los equipos de 32 bits y un entero de 64 bits en los equipos de 64 bits.

Atributos
SecurityCriticalAttribute

Excepciones

AccessViolationException

ptr no es un formato reconocido.

o bien

ptr es null.

o bien

ptr no es válido.

Ejemplos

En el ejemplo siguiente se muestra cómo leer y escribir en una matriz no administrada mediante los ReadIntPtr métodos y WriteIntPtr .

static void ReadWriteIntPtr()
{
    // Allocate unmanaged memory. 
    int elementSize = Marshal.SizeOf(typeof(IntPtr));
    IntPtr unmanagedArray = Marshal.AllocHGlobal(10 * elementSize);

    // Set the 10 elements of the C-style unmanagedArray
    for (int i = 0; i < 10; i++)
    {
        Marshal.WriteIntPtr(unmanagedArray, i * elementSize, ((IntPtr)(i + 1)));
    }
    Console.WriteLine("Unmanaged memory written.");

    Console.WriteLine("Reading unmanaged memory:");
    // Print the 10 elements of the C-style unmanagedArray
    for (int i = 0; i < 10; i++)
    {
        Console.WriteLine(Marshal.ReadIntPtr(unmanagedArray, i * elementSize));
    }

    Marshal.FreeHGlobal(unmanagedArray);

    Console.WriteLine("Done. Press Enter to continue.");
    Console.ReadLine();
}

Sub ReadWriteIntPtr()
    ' Allocate unmanaged memory.
    Dim elementSize As Integer = Marshal.SizeOf(GetType(IntPtr))
    Dim unmanagedArray As IntPtr = Marshal.AllocHGlobal(10 * elementSize)

    ' Set the 10 elements of the C-style unmanagedArray
    For i As Integer = 0 To 9
        Marshal.WriteIntPtr(unmanagedArray, i * elementSize, CType(i + 1, IntPtr))
    Next i
    Console.WriteLine("Unmanaged memory written.")

    Console.WriteLine("Reading unmanaged memory:")
    ' Print the 10 elements of the C-style unmanagedArray
    For i As Integer = 0 To 9
        Console.WriteLine(Marshal.ReadIntPtr(unmanagedArray, i * elementSize))
    Next i

    Marshal.FreeHGlobal(unmanagedArray)

    Console.WriteLine("Done. Press Enter to continue.")
    Console.ReadLine()
End Sub

Comentarios

ReadIntPtr tiene un desplazamiento implícito de 0. Este método permite la interacción directa con una matriz de estilo IntPtr C no administrada, lo que elimina el gasto de copiar una matriz no administrada completa (mediante Marshal.Copy) en una matriz administrada independiente antes de leer sus valores de elemento.

Se admite la lectura desde ubicaciones de memoria desalineadas.

Consulte también

Se aplica a