Marshal.ReadIntPtr Methode

Definition

Namespace:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

Liest eine systemeigene Prozessorgröße ganze Zahl aus nicht verwaltetem Speicher. Das Lesen von nicht ausgerichteten Speicherspeicherorten wird unterstützt.

Überlädt

ReadIntPtr(IntPtr, Int32)	Liest eine systemeigene Prozessorgröße ganze Zahl bei einem bestimmten Offset aus nicht verwaltetem Speicher.
ReadIntPtr(Object, Int32)	Veraltet. Liest eine systemeigene Prozessorgröße ganze Zahl aus nicht verwaltetem Speicher.
ReadIntPtr(IntPtr)	Liest eine prozessoreigene ganzzahlige Zahl aus nicht verwaltetem Arbeitsspeicher.

ReadIntPtr(IntPtr, Int32)

Quelle:

Marshal.cs

Liest eine systemeigene Prozessorgröße ganze Zahl bei einem bestimmten Offset aus nicht verwaltetem 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, aus dem gelesen werden soll.

ofs

Int32

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

Gibt zurück

IntPtr

nativeint

Die ganze Zahl, die aus dem nicht verwalteten Speicher beim angegebenen Offset gelesen wird.

Ausnahmen

AccessViolationException

Basisadresse (ptr) plus Offsetbyte (ofs) erzeugt eine NULL- oder ungültige Adresse.

Beispiele

Im folgenden Beispiel wird das Lesen und Schreiben in ein nicht verwaltetes Array mithilfe der methoden ReadIntPtr und WriteIntPtr veranschaulicht.

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 C-Format IntPtr Array, wodurch die Kosten für das Kopieren eines gesamten nicht verwalteten Arrays (mithilfe von Marshal.Copy) in ein separates verwaltetes Array vermieden werden, bevor die Elementwerte gelesen werden.

Das Lesen von nicht ausgerichteten Speicherspeicherorten 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 systemeigene Prozessorgröße ganze Zahl aus nicht verwaltetem 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 Byte-Offset, der vor dem Lesen zum ptr Parameter hinzugefügt wird.

Gibt zurück

IntPtr

nativeint

Die ganze Zahl, die aus dem nicht verwalteten Speicher beim angegebenen Offset gelesen wird.

Attribute

ObsoleteAttribute

Ausnahmen

AccessViolationException

Basisadresse (ptr) plus Offsetbyte (ofs) erzeugt eine NULL- oder 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 C-Format IntPtr Array, wodurch die Kosten für das Kopieren eines gesamten nicht verwalteten Arrays (mithilfe von Marshal.Copy) in ein separates verwaltetes Array vermieden werden, bevor die Elementwerte gelesen werden.

Das Lesen von nicht ausgerichteten Speicherspeicherorten wird unterstützt.

Weitere Informationen

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

ReadIntPtr(IntPtr)

Quelle:

Marshal.cs

Liest eine prozessoreigene ganzzahlige Zahl aus nicht verwaltetem Arbeitsspeicher.

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, aus dem gelesen werden soll.

Gibt zurück

IntPtr

nativeint

Die ganze Zahl, die aus nicht verwalteten Arbeitsspeicher gelesen wird. Eine 32-Bit-Ganzzahl wird auf 32-Bit-Computern zurückgegeben, und eine 64-Bit-Ganzzahl wird auf 64-Bit-Computern zurückgegeben.

Ausnahmen

AccessViolationException

ptr ist kein erkanntes Format.

-oder-

ptr ist null.

-oder-

ptr ist ungültig.

Beispiele

Im folgenden Beispiel wird das Lesen und Schreiben in ein nicht verwaltetes Array mithilfe der methoden ReadIntPtr und WriteIntPtr veranschaulicht.

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 implizierten Offset von 0 auf. Diese Methode ermöglicht die direkte Interaktion mit einem nicht verwalteten C-Format IntPtr Array, wodurch die Kosten für das Kopieren eines gesamten nicht verwalteten Arrays (unter Verwendung von Marshal.Copy) in ein separates verwaltetes Array vermieden werden, bevor die Elementwerte gelesen werden.

Das Lesen von nicht ausgerichteten Speicherspeicherorten wird unterstützt.

Weitere Informationen

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