Marshal.ReadIntPtr Metoda

Definice

Obor názvů:

System.Runtime.InteropServices

Sestavení:

System.Runtime.InteropServices.dll

Čte celé číslo nativní velikosti procesoru z nespravované paměti. Podporuje se čtení z nezarovnaných umístění v paměti.

Přetížení

ReadIntPtr(IntPtr, Int32)	Čte celé číslo nativní velikosti procesoru při daném posunu od nespravované paměti.
ReadIntPtr(Object, Int32)	Zastaralé. Čte celé číslo nativní velikosti procesoru z nespravované paměti.
ReadIntPtr(IntPtr)	Načte celé číslo nativní velikosti procesoru z nespravované paměti.

ReadIntPtr(IntPtr, Int32)

Zdroj:

Marshal.cs

Čte celé číslo nativní velikosti procesoru při daném posunu od nespravované paměti.

public:
 static IntPtr ReadIntPtr(IntPtr ptr, int ofs);

public static IntPtr ReadIntPtr (IntPtr ptr, int ofs);

static member ReadIntPtr : nativeint * int -> nativeint

Public Shared Function ReadIntPtr (ptr As IntPtr, ofs As Integer) As IntPtr

Parametry

ptr

IntPtr

nativeint

Základní adresa v nespravované paměti, ze které se má číst.

ofs

Int32

Další posun bajtů, který se přidá do parametru ptr před čtením.

Návraty

IntPtr

nativeint

Celé číslo čtené z nespravované paměti při daném posunu.

Výjimky

AccessViolationException

Základní adresa (ptr) a posunutého bajtu (ofs) vytváří adresu s hodnotou null nebo neplatnou.

Příklady

Následující příklad ukazuje, jak číst a zapisovat do nespravovaného pole pomocí ReadIntPtr metod a 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

Poznámky

ReadIntPtr umožňuje přímou interakci s nespravovaným polem ve stylu IntPtr jazyka C, čímž eliminuje náklady spojené s kopírováním celého nespravovaného pole (pomocí Marshal.Copy) do samostatného spravovaného pole před čtením hodnot jeho prvků.

Podporuje se čtení z nezarovnaných umístění v paměti.

Viz také

• Copy(Int32[], Int32, IntPtr, Int32)
• ReadByte(Object, Int32)

ReadIntPtr(Object, Int32)

Zdroj:

Marshal.cs

Upozornění

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

Čte celé číslo nativní velikosti procesoru z nespravované paměti.

public:
 static IntPtr ReadIntPtr(System::Object ^ ptr, int ofs);

[System.Obsolete("ReadIntPtr(Object, Int32) may be unavailable in future releases.")]
public static IntPtr ReadIntPtr (object ptr, int ofs);

[<System.Obsolete("ReadIntPtr(Object, Int32) may be unavailable in future releases.")>]
static member ReadIntPtr : obj * int -> nativeint

Public Shared Function ReadIntPtr (ptr As Object, ofs As Integer) As IntPtr

Parametry

ptr

Object

Základní adresa zdrojového objektu v nespravované paměti.

ofs

Int32

Další posun bajtů, který se přidá do parametru ptr před čtením.

Návraty

IntPtr

nativeint

Celé číslo čtené z nespravované paměti při daném posunu.

Atributy

ObsoleteAttribute

Výjimky

AccessViolationException

Základní adresa (ptr) a posunutého bajtu (ofs) vytváří adresu s hodnotou null nebo neplatnou.

ArgumentException

ptrArrayWithOffset je objekt. Tato metoda nepřijímá ArrayWithOffset parametry.

Poznámky

ReadIntPtr umožňuje přímou interakci s nespravovaným polem ve stylu IntPtr jazyka C, čímž eliminuje náklady spojené s kopírováním celého nespravovaného pole (pomocí Marshal.Copy) do samostatného spravovaného pole před čtením hodnot jeho prvků.

Podporuje se čtení z nezarovnaných umístění v paměti.

Viz také

• Copy(Int32[], Int32, IntPtr, Int32)

ReadIntPtr(IntPtr)

Zdroj:

Marshal.cs

Načte celé číslo nativní velikosti procesoru z nespravované paměti.

public:
 static IntPtr ReadIntPtr(IntPtr ptr);

public static IntPtr ReadIntPtr (IntPtr ptr);

static member ReadIntPtr : nativeint -> nativeint

Public Shared Function ReadIntPtr (ptr As IntPtr) As IntPtr

Parametry

ptr

IntPtr

nativeint

Adresa v nespravované paměti, ze které se má číst.

Návraty

IntPtr

nativeint

Celé číslo čtené z nespravované paměti. Na 32bitových počítačích se vrátí 32bitové celé číslo a na 64bitových počítačích se vrátí 64bitové celé číslo.

Výjimky

AccessViolationException

ptr není rozpoznaný formát.

-nebo-

ptr je null.

-nebo-

Formát ptr je neplatný.

Příklady

Následující příklad ukazuje, jak číst a zapisovat do nespravovaného pole pomocí ReadIntPtr metod a 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

Poznámky

ReadIntPtr má implicitní posun 0. Tato metoda umožňuje přímou interakci s nespravovaným polem ve stylu IntPtr jazyka C, čímž eliminuje náklady na kopírování celého nespravovaného pole (pomocí Marshal.Copy) do samostatného spravovaného pole před čtením hodnot jeho prvků.

Podporuje se čtení z nezarovnaných umístění v paměti.

Viz také

• Copy(Int32[], Int32, IntPtr, Int32)