Marshal.ReadIntPtr Méthode

  • Référence

Définition

Espace de noms:
System.Runtime.InteropServices
Assembly:
System.Runtime.InteropServices.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Lit un entier natif dimensionné par processeur à partir de la mémoire non managée. La lecture depuis des emplacements mémoire non alignés est prise en charge.

Surcharges

ReadIntPtr(IntPtr, Int32)

Lit un entier natif dimensionné par processeur à un offset donné dans la mémoire non managée.
ReadIntPtr(Object, Int32)
Obsolète.

Lit un entier natif dimensionné par processeur à partir de la mémoire non managée.
ReadIntPtr(IntPtr)

Lit un entier natif dimensionné par processeur dans la mémoire non managée.

ReadIntPtr(IntPtr, Int32)

Source:
Marshal.cs
Source:
Marshal.cs
Source:
Marshal.cs

Lit un entier natif dimensionné par processeur à un offset donné dans la mémoire non managée.

public:
 static IntPtr ReadIntPtr(IntPtr ptr, int ofs);
[System.Security.SecurityCritical]
public static IntPtr ReadIntPtr (IntPtr ptr, int ofs);
public static IntPtr ReadIntPtr (IntPtr ptr, int ofs);
[<System.Security.SecurityCritical>]
static member ReadIntPtr : nativeint * int -> nativeint
static member ReadIntPtr : nativeint * int -> nativeint
Public Shared Function ReadIntPtr (ptr As IntPtr, ofs As Integer) As IntPtr

Paramètres

ptr
IntPtr

nativeint

Adresse de base dans la mémoire non managée où commencer la lecture.

ofs
Int32

Offset d'octet supplémentaire, qui est ajouté au paramètre ptr avant la lecture.

Retours

IntPtr

nativeint

Entier lu dans la mémoire non managée à l'offset donné.

Attributs
SecurityCriticalAttribute

Exceptions

AccessViolationException

L'adresse de base (ptr) plus l'octet d'offset (ofs) produisent une adresse null ou non valide.

Exemples

L’exemple suivant montre comment lire et écrire dans un tableau non managé à l’aide des ReadIntPtr méthodes et 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

Remarques

ReadIntPtr permet l’interaction directe avec un tableau de style IntPtr C non managé, éliminant les frais de copie d’un tableau non managé entier (à l’aide Marshal.Copyde ) dans un tableau managé distinct avant de lire ses valeurs d’élément.

La lecture depuis des emplacements mémoire non alignés est prise en charge.

Voir aussi

S’applique à

ReadIntPtr(Object, Int32)

Source:
Marshal.cs
Source:
Marshal.cs
Source:
Marshal.cs

Attention

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

Lit un entier natif dimensionné par processeur à partir de la mémoire non managée.

public:
 static IntPtr ReadIntPtr(System::Object ^ ptr, int ofs);
[System.Obsolete("ReadIntPtr(Object, Int32) may be unavailable in future releases.")]
[System.Security.SecurityCritical]
public static IntPtr ReadIntPtr (object ptr, int ofs);
[System.Obsolete("ReadIntPtr(Object, Int32) may be unavailable in future releases.")]
public static IntPtr ReadIntPtr (object ptr, int ofs);
public static IntPtr ReadIntPtr (object ptr, int ofs);
[System.Security.SecurityCritical]
public static IntPtr ReadIntPtr (object ptr, int ofs);
[<System.Obsolete("ReadIntPtr(Object, Int32) may be unavailable in future releases.")>]
[<System.Security.SecurityCritical>]
static member ReadIntPtr : obj * int -> nativeint
[<System.Obsolete("ReadIntPtr(Object, Int32) may be unavailable in future releases.")>]
static member ReadIntPtr : obj * int -> nativeint
static member ReadIntPtr : obj * int -> nativeint
[<System.Security.SecurityCritical>]
static member ReadIntPtr : obj * int -> nativeint
Public Shared Function ReadIntPtr (ptr As Object, ofs As Integer) As IntPtr

Paramètres

ptr
Object

Adresse de base dans la mémoire non managée de l'objet source.

ofs
Int32

Offset d'octet supplémentaire, qui est ajouté au paramètre ptr avant la lecture.

Retours

IntPtr

nativeint

Entier lu dans la mémoire non managée à l'offset donné.

Attributs
ObsoleteAttribute SecurityCriticalAttribute

Exceptions

AccessViolationException

L'adresse de base (ptr) plus l'octet d'offset (ofs) produisent une adresse null ou non valide.

ArgumentException

ptr est un objet ArrayWithOffset. Cette méthode n'accepte pas les paramètres ArrayWithOffset.

Remarques

ReadIntPtr permet l’interaction directe avec un tableau de style IntPtr C non managé, éliminant les frais de copie d’un tableau non managé entier (à l’aide Marshal.Copyde ) dans un tableau managé distinct avant de lire ses valeurs d’élément.

La lecture depuis des emplacements mémoire non alignés est prise en charge.

Voir aussi

S’applique à

ReadIntPtr(IntPtr)

Source:
Marshal.cs
Source:
Marshal.cs
Source:
Marshal.cs

Lit un entier natif dimensionné par processeur dans la mémoire non managée.

public:
 static IntPtr ReadIntPtr(IntPtr ptr);
[System.Security.SecurityCritical]
public static IntPtr ReadIntPtr (IntPtr ptr);
public static IntPtr ReadIntPtr (IntPtr ptr);
[<System.Security.SecurityCritical>]
static member ReadIntPtr : nativeint -> nativeint
static member ReadIntPtr : nativeint -> nativeint
Public Shared Function ReadIntPtr (ptr As IntPtr) As IntPtr

Paramètres

ptr
IntPtr

nativeint

Adresse de début de lecture dans la mémoire non managée.

Retours

IntPtr

nativeint

Entier lu dans la mémoire non managée. Un entier 32 bits est retourné sur les ordinateurs 32 bits et un entier 64 bits est retourné sur les ordinateurs 64 bits.

Attributs
SecurityCriticalAttribute

Exceptions

AccessViolationException

ptr n'est pas un format reconnu.

- ou -

ptr a la valeur null.

- ou -

ptr n'est pas valide.

Exemples

L’exemple suivant montre comment lire et écrire dans un tableau non managé à l’aide des ReadIntPtr méthodes et 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

Remarques

ReadIntPtr a un décalage implicite de 0. Cette méthode permet l’interaction directe avec un tableau de style IntPtr C non managé, éliminant les frais de copie d’un tableau non managé entier (à l’aide Marshal.Copyde ) dans un tableau managé distinct avant de lire ses valeurs d’élément.

La lecture depuis des emplacements mémoire non alignés est prise en charge.

Voir aussi

S’applique à