Marshal.ReadIntPtr Methode

Definition

Namespace:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

Liest eine ganze Zahl von prozessoreigener Größe aus dem nicht verwalteten Speicher. Das Lesen aus nicht ausgerichteten Speicheradressen wird unterstützt.

Überlädt

ReadIntPtr(IntPtr, Int32)	Liest eine ganze Zahl von prozessoreigener Größe an einem angegebenen Offset aus dem nicht verwalteten Speicher.
ReadIntPtr(Object, Int32)	Veraltet. Liest eine ganze Zahl von prozessoreigener Größe aus dem nicht verwalteten Speicher.
ReadIntPtr(IntPtr)	Liest eine ganze Zahl von prozessoreigener Größe aus dem nicht verwalteten Speicher.

ReadIntPtr(IntPtr, Int32)

Quelle:

Marshal.cs

Liest eine ganze Zahl von prozessoreigener Größe an einem angegebenen Offset aus dem nicht verwalteten Speicher.

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

Parameter

ptr

IntPtr

nativeint

Die Basisadresse im nicht verwalteten Speicher, an der gelesen werden soll.

ofs

Int32

Ein zusätzlicher Byteoffset, der dem ptr-Parameter vor dem Lesen hinzugefügt wird.

Gibt zurück

IntPtr

nativeint

Die aus dem nicht verwalteten Arbeitsspeicher am angegebenen Offset gelesene ganze Zahl.

Ausnahmen

AccessViolationException

Die Basisadresse (ptr) und das Offsetbyte (ofs) erzeugen NULL oder eine ungültige Adresse.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie sie mit den ReadIntPtrWriteIntPtr Methoden und lesen und in ein nicht verwaltetes Array schreiben.

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

Hinweise

ReadIntPtr ermöglicht die direkte Interaktion mit einem nicht verwalteten Array im C-Stil IntPtr , wodurch der Aufwand für das Kopieren eines gesamten nicht verwalteten Arrays (mit Marshal.Copy) in ein separates verwaltetes Array vor dem Lesen der Elementwerte entfällt.

Das Lesen aus nicht ausgerichteten Speicheradressen wird unterstützt.

Weitere Informationen

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

ReadIntPtr(Object, Int32)

Quelle:

Marshal.cs

Achtung

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

Liest eine ganze Zahl von prozessoreigener Größe aus dem nicht verwalteten Speicher.

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

Parameter

ptr

Object

Die Basisadresse im nicht verwalteten Speicher des Quellobjekts.

ofs

Int32

Ein zusätzlicher Byteoffset, der dem ptr-Parameter vor dem Lesen hinzugefügt wird.

Gibt zurück

IntPtr

nativeint

Die aus dem nicht verwalteten Arbeitsspeicher am angegebenen Offset gelesene ganze Zahl.

Attribute

ObsoleteAttribute

Ausnahmen

AccessViolationException

Die Basisadresse (ptr) und das Offsetbyte (ofs) erzeugen NULL oder eine ungültige Adresse.

ArgumentException

ptr ist ein ArrayWithOffset-Objekt. Diese Methode akzeptiert keine ArrayWithOffset-Parameter.

Hinweise

ReadIntPtr ermöglicht die direkte Interaktion mit einem nicht verwalteten Array im C-Stil IntPtr , wodurch der Aufwand für das Kopieren eines gesamten nicht verwalteten Arrays (mit Marshal.Copy) in ein separates verwaltetes Array vor dem Lesen der Elementwerte entfällt.

Das Lesen aus nicht ausgerichteten Speicheradressen wird unterstützt.

Weitere Informationen

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

ReadIntPtr(IntPtr)

Quelle:

Marshal.cs

Liest eine ganze Zahl von prozessoreigener Größe aus dem nicht verwalteten Speicher.

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

Parameter

ptr

IntPtr

nativeint

Die Adresse im nicht verwalteten Speicher, an der gelesen werden soll.

Gibt zurück

IntPtr

nativeint

Die aus dem nicht verwaltetem Arbeitsspeicher gelesene Ganzzahl. Auf 32-Bit-Computern wird eine 32-Bit-Ganzzahl zurückgegeben und auf 64-Bit-Computern eine 64-Bit-Ganzzahl.

Ausnahmen

AccessViolationException

ptr ist kein erkanntes Format.

- oder -

ptr ist null.

- oder -

ptr ist ungültig.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie sie mit den ReadIntPtrWriteIntPtr Methoden und lesen und in ein nicht verwaltetes Array schreiben.

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

Hinweise

ReadIntPtr weist einen impliziten Offset von 0 auf. Diese Methode ermöglicht die direkte Interaktion mit einem nicht verwalteten Array im C-Stil IntPtr , wodurch der Aufwand für das Kopieren eines gesamten nicht verwalteten Arrays (mit Marshal.Copy) in ein separates verwaltetes Array vor dem Lesen der Elementwerte entfällt.

Das Lesen aus nicht ausgerichteten Speicheradressen wird unterstützt.

Weitere Informationen

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