Marshal.ReadIntPtr Metoda

Definicja

Przestrzeń nazw:

System.Runtime.InteropServices

Zestaw:

System.Runtime.InteropServices.dll

Odczytuje liczbę całkowitą o rozmiarze natywnym procesora z pamięci niezarządzanej. Odczyt z nieprzygotowanych lokalizacji pamięci jest obsługiwany.

Przeciążenia

ReadIntPtr(IntPtr, Int32)	Odczytuje liczbę całkowitą o rozmiarze natywnym procesora przy danym przesunięciu z pamięci niezarządzanej.
ReadIntPtr(Object, Int32)	Przestarzałe. Odczytuje liczbę całkowitą o rozmiarze natywnym procesora z pamięci niezarządzanej.
ReadIntPtr(IntPtr)	Odczytuje liczbę całkowitą o rozmiarze natywnym procesora z niezarządzanej pamięci.

ReadIntPtr(IntPtr, Int32)

Źródło:

Marshal.cs

Odczytuje liczbę całkowitą o rozmiarze natywnym procesora przy danym przesunięciu z pamięci niezarządzanej.

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

Adres podstawowy w niezarządzanej pamięci, z której ma być odczytywany.

ofs

Int32

Dodatkowe przesunięcie bajtów, które jest dodawane do parametru przed odczytaniem ptr .

Zwraca

IntPtr

nativeint

Liczba całkowita odczytana z niezarządzanej pamięci przy danym przesunięcie.

Wyjątki

AccessViolationException

Adres podstawowy (ptr) plus bajt przesunięcia (ofs) tworzy adres o wartości null lub nieprawidłowy.

Przykłady

W poniższym przykładzie pokazano, jak odczytywać i zapisywać dane w niezarządzanej tablicy przy użyciu ReadIntPtr metod i 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

Uwagi

ReadIntPtr umożliwia bezpośrednią interakcję z niezarządzaną tablicą w stylu IntPtr języka C, eliminując koszty kopiowania całej niezarządzanej tablicy (przy użyciu metody Marshal.Copy) do oddzielnej zarządzanej tablicy przed odczytaniem jej wartości elementów.

Odczyt z nieprzygotowanych lokalizacji pamięci jest obsługiwany.

Zobacz też

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

ReadIntPtr(Object, Int32)

Źródło:

Marshal.cs

Przestroga

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

Odczytuje liczbę całkowitą o rozmiarze natywnym procesora z pamięci niezarządzanej.

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

Adres podstawowy w niezarządzanej pamięci obiektu źródłowego.

ofs

Int32

Dodatkowe przesunięcie bajtów, które jest dodawane do parametru przed odczytaniem ptr .

Zwraca

IntPtr

nativeint

Liczba całkowita odczytana z niezarządzanej pamięci przy danym przesunięcie.

Atrybuty

ObsoleteAttribute

Wyjątki

AccessViolationException

Adres podstawowy (ptr) plus bajt przesunięcia (ofs) tworzy adres o wartości null lub nieprawidłowy.

ArgumentException

ptr jest obiektem ArrayWithOffset . Ta metoda nie akceptuje ArrayWithOffset parametrów.

Uwagi

ReadIntPtr umożliwia bezpośrednią interakcję z niezarządzaną tablicą w stylu IntPtr języka C, eliminując koszty kopiowania całej niezarządzanej tablicy (przy użyciu metody Marshal.Copy) do oddzielnej zarządzanej tablicy przed odczytaniem jej wartości elementów.

Odczyt z nieprzygotowanych lokalizacji pamięci jest obsługiwany.

Zobacz też

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

ReadIntPtr(IntPtr)

Źródło:

Marshal.cs

Odczytuje liczbę całkowitą o rozmiarze natywnym procesora z niezarządzanej pamięci.

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

Adres w pamięci niezarządzanej, z której ma być odczytywany.

Zwraca

IntPtr

nativeint

Liczba całkowita odczytana z niezarządzanej pamięci. 32-bitowa liczba całkowita jest zwracana na 32-bitowych maszynach, a liczba całkowita 64-bitowa jest zwracana na maszynach 64-bitowych.

Wyjątki

AccessViolationException

ptr nie jest rozpoznawanym formatem.

-lub-

ptr to null.

-lub-

Nazwa ptr jest niepoprawna.

Przykłady

W poniższym przykładzie pokazano, jak odczytywać i zapisywać dane w niezarządzanej tablicy przy użyciu ReadIntPtr metod i 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

Uwagi

ReadIntPtr ma dorozumiane przesunięcie 0. Ta metoda umożliwia bezpośrednią interakcję z niezarządzaną tablicą w stylu IntPtr języka C, eliminując koszty kopiowania całej niezarządzanej tablicy (przy użyciu metody Marshal.Copy) do oddzielnej zarządzanej tablicy przed odczytaniem jej wartości elementów.

Odczyt z nieprzygotowanych lokalizacji pamięci jest obsługiwany.

Zobacz też

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