Marshal.ReadIntPtr Méthode

Définition

Espace de noms:: System.Runtime.InteropServices

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

Assembly:: mscorlib.dll

Assembly:: System.Runtime.InteropServices.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Lit un entier de taille native du processeur à partir de la mémoire non managée. La lecture à partir d’emplacements de mémoire non alignés est prise en charge.

Surcharges

Nom	Description
ReadIntPtr(IntPtr, Int32)	Lit un entier de taille native du processeur à un décalage donné de la mémoire non managée.
ReadIntPtr(Object, Int32)	Obsolète. Lit un entier de taille native du processeur à partir de la mémoire non managée.
ReadIntPtr(IntPtr)	Lit un entier de taille native du processeur à partir de la mémoire non managée.

ReadIntPtr(IntPtr, Int32)

Lit un entier de taille native du processeur à un décalage donné de 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 à partir de laquelle lire.

ofs: Int32

Décalage d’octet supplémentaire, ajouté au paramètre avant la ptr lecture.

Retours

IntPtr

nativeint

Entier lu à partir de la mémoire non managée au décalage donné.

Attributs: SecurityCriticalAttribute

Exceptions

AccessViolationException

L’adresse de base (ptr) plus l’octet de décalage (ofs) produit une adresse null ou non valide.

Exemples

L’exemple suivant montre comment lire et écrire dans un tableau non managé à l’aide des méthodes et WriteIntPtr des ReadIntPtr méthodes.

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 une interaction directe avec un tableau de style IntPtr C non managé, éliminant les frais de copie d’un tableau non managé entier (utilisant Marshal.Copy) dans un tableau managé distinct avant de lire ses valeurs d’élément.

La lecture à partir d’emplacements de mémoire non alignés est prise en charge.

Voir aussi

S’applique à

ReadIntPtr(Object, Int32)

Attention

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

Lit un entier de taille native du 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);

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.")]
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

static member ReadIntPtr : obj * int -> nativeint

[<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

Public Shared Function ReadIntPtr (ptr As Object, ofs As Integer) As IntPtr

Paramètres

ptr: Object

Adresse de base en mémoire non managée de l’objet source.

ofs: Int32

Décalage d’octet supplémentaire, ajouté au paramètre avant la ptr lecture.

Retours

IntPtr

nativeint

Entier lu à partir de la mémoire non managée au décalage donné.

Attributs: ObsoleteAttribute SecurityCriticalAttribute

Exceptions

AccessViolationException

L’adresse de base (ptr) plus l’octet de décalage (ofs) produit une adresse null ou non valide.

ArgumentException

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

Remarques

La lecture à partir d’emplacements de mémoire non alignés est prise en charge.

Voir aussi

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

S’applique à

ReadIntPtr(IntPtr)

Lit un entier de taille native du processeur à partir de 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 dans la mémoire non managée à partir de laquelle lire.

Retours

IntPtr

nativeint

Entier lu à partir de la mémoire non managée. Un entier 32 bits est retourné sur des machines 32 bits et un entier 64 bits est retourné sur les machines 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 méthodes et WriteIntPtr des ReadIntPtr méthodes.

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 une interaction directe avec un tableau de style IntPtr C non managé, éliminant ainsi les frais de copie d’un tableau non managé (utilisant Marshal.Copy) dans un tableau managé distinct avant de lire ses valeurs d’élément.

La lecture à partir d’emplacements de mémoire non alignés est prise en charge.

Voir aussi

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

S’applique à

Commentaires

Cette page a-t-elle été utile ?