Marshal.ReadIntPtr Méthode

Définition

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.

C#
[System.Security.SecurityCritical]
public static IntPtr ReadIntPtr (IntPtr ptr, int ofs);
C#
public static IntPtr ReadIntPtr (IntPtr ptr, int ofs);

Paramètres

ptr
IntPtr

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

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

Attributs

Exceptions

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 .

C#
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();
}

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 à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

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.

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

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

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

Attributs

Exceptions

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

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 à

.NET 9 et autres versions
Produit Versions (Obsolète)
.NET (Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9)
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 2.0 (1.2, 1.3, 1.4, 1.5, 1.6, 2.1)
UWP (10.0)

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.

C#
[System.Security.SecurityCritical]
public static IntPtr ReadIntPtr (IntPtr ptr);
C#
public static IntPtr ReadIntPtr (IntPtr ptr);

Paramètres

ptr
IntPtr

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

Retours

IntPtr

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

Exceptions

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 .

C#
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();
}

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 à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0