Marshal.WriteIntPtr Methode

Definition

Namespace:: System.Runtime.InteropServices

Assemblys:: mscorlib.dll, System.Runtime.InteropServices.dll

Assembly:: mscorlib.dll

Assembly:: System.Runtime.InteropServices.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Schreibt einen ganzzahligen Wert der prozessoreigenen Größe in nicht verwalteten Arbeitsspeicher. 32-Bit-Ganzzahlen werden auf 32-Bit-Systemen geschrieben, und 64-Bit-Ganzzahlen werden auf 64-Bit-Systemen geschrieben. Das Schreiben in nicht ausgerichtete Speicherspeicherorte wird unterstützt.

Überlädt

Name	Beschreibung
WriteIntPtr(IntPtr, IntPtr)	Schreibt einen ganzzahligen Wert der prozessoreigenen Größe in nicht verwalteten Arbeitsspeicher.
WriteIntPtr(IntPtr, Int32, IntPtr)	Schreibt einen ganzzahligen Wert der prozessoreigenen Größe in nicht verwalteten Speicher in einem angegebenen Offset.
WriteIntPtr(Object, Int32, IntPtr)	Veraltet. Schreibt einen ganzzahligen Wert der prozessoreigenen Größe in nicht verwalteten Arbeitsspeicher.

WriteIntPtr(IntPtr, IntPtr)

Schreibt einen ganzzahligen Wert der prozessoreigenen Größe in nicht verwalteten Arbeitsspeicher.

public:
 static void WriteIntPtr(IntPtr ptr, IntPtr val);

[System.Security.SecurityCritical]
public static void WriteIntPtr(IntPtr ptr, IntPtr val);

public static void WriteIntPtr(IntPtr ptr, IntPtr val);

[<System.Security.SecurityCritical>]
static member WriteIntPtr : nativeint * nativeint -> unit

static member WriteIntPtr : nativeint * nativeint -> unit

Public Shared Sub WriteIntPtr (ptr As IntPtr, val As IntPtr)

Parameter

ptr: IntPtr
nativeint

Die Adresse im nicht verwalteten Speicher, in die geschrieben werden soll.

val: IntPtr
nativeint

Der zu schreibende Wert.

Attribute: SecurityCriticalAttribute

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 und WriteIntPtr der ReadIntPtr Methoden 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

WriteIntPtr ermöglicht direkte Interaktion mit einem nicht verwalteten C-Array IntPtr , wodurch die Kosten für das Kopieren eines gesamten nicht verwalteten Arrays (unter Verwendung Marshal.Copy) in ein separates verwaltetes Array vermieden werden, bevor die Elementwerte festgelegt werden.

Das Schreiben in nicht ausgerichtete Speicherspeicherorte wird unterstützt.

Weitere Informationen

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

Gilt für:

WriteIntPtr(IntPtr, Int32, IntPtr)

Schreibt einen ganzzahligen Wert der prozessoreigenen Größe in nicht verwalteten Speicher in einem angegebenen Offset.

public:
 static void WriteIntPtr(IntPtr ptr, int ofs, IntPtr val);

[System.Security.SecurityCritical]
public static void WriteIntPtr(IntPtr ptr, int ofs, IntPtr val);

public static void WriteIntPtr(IntPtr ptr, int ofs, IntPtr val);

[<System.Security.SecurityCritical>]
static member WriteIntPtr : nativeint * int * nativeint -> unit

static member WriteIntPtr : nativeint * int * nativeint -> unit

Public Shared Sub WriteIntPtr (ptr As IntPtr, ofs As Integer, val As IntPtr)

Parameter

ptr: IntPtr
nativeint

Die Basisadresse im nicht verwalteten Arbeitsspeicher, in die geschrieben werden soll.

ofs: Int32

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

val: IntPtr
nativeint

Der zu schreibende Wert.

Attribute: SecurityCriticalAttribute

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 und WriteIntPtr der ReadIntPtr Methoden 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

Diese Methode schreibt eine 32-Bit-Ganzzahl auf 32-Bit-Systemen und eine 64-Bit-Ganzzahl auf 64-Bit-Systemen.

Das Schreiben in nicht ausgerichtete Speicherspeicherorte wird unterstützt.

Weitere Informationen

Gilt für:

WriteIntPtr(Object, Int32, IntPtr)

Achtung

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

Schreibt einen ganzzahligen Wert der prozessoreigenen Größe in nicht verwalteten Arbeitsspeicher.

public:
 static void WriteIntPtr(System::Object ^ ptr, int ofs, IntPtr val);

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

public static void WriteIntPtr(object ptr, int ofs, IntPtr val);

[System.Security.SecurityCritical]
public static void WriteIntPtr(object ptr, int ofs, IntPtr val);

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

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

static member WriteIntPtr : obj * int * nativeint -> unit

[<System.Security.SecurityCritical>]
static member WriteIntPtr : obj * int * nativeint -> unit

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

Public Shared Sub WriteIntPtr (ptr As Object, ofs As Integer, val As IntPtr)

Parameter

ptr: Object

Die Basisadresse im nicht verwalteten Speicher des Zielobjekts.

ofs: Int32

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

val: IntPtr
nativeint

Der zu schreibende Wert.

Attribute: ObsoleteAttribute SecurityCriticalAttribute

Ausnahmen

AccessViolationException

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

ArgumentException

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

Hinweise

WriteIntPtr ermöglicht direkte Interaktion mit einem nicht verwalteten C-Bytearray, wodurch die Kosten für das Kopieren eines gesamten nicht verwalteten Arrays (unter Verwendung Marshal.Copy) in ein separates verwaltetes Array vermieden werden, bevor die Elementwerte festgelegt werden.

Das Schreiben in nicht ausgerichtete Speicherspeicherorte wird unterstützt.

Weitere Informationen

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

Gilt für:

Feedback

War diese Seite hilfreich?