Marshal.ReadInt16 Méthode

Définition

Espace de noms:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

Lit un entier 16 bits signé à partir de la mémoire non managée. La lecture depuis des emplacements mémoire non alignés est prise en charge.

Surcharges

ReadInt16(IntPtr)	Lit un entier 16 bits signé à partir de la mémoire non managée.
ReadInt16(IntPtr, Int32)	Lit un entier signé 16 bits à un offset donné dans la mémoire non managée.
ReadInt16(Object, Int32)	Obsolète. Lit un entier signé 16 bits à un offset donné dans la mémoire non managée.

ReadInt16(IntPtr)

Source:

Marshal.cs

Lit un entier 16 bits signé à partir de la mémoire non managée.

public:
 static short ReadInt16(IntPtr ptr);

public static short ReadInt16 (IntPtr ptr);

static member ReadInt16 : nativeint -> int16

Public Shared Function ReadInt16 (ptr As IntPtr) As Short

Paramètres

ptr

IntPtr

nativeint

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

Retours

Int16

Entier signé 16 bits lu dans la mémoire non managée.

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 ReadInt16 méthodes et WriteInt16 .

static void ReadWriteInt16()
{
    // Allocate unmanaged memory. 
    int elementSize = 2;
    IntPtr unmanagedArray = Marshal.AllocHGlobal(10 * elementSize);

    // Set the 10 elements of the C-style unmanagedArray
    for (int i = 0; i < 10; i++)
    {
        Marshal.WriteInt16(unmanagedArray, i * elementSize, ((Int16)(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.ReadInt16(unmanagedArray, i * elementSize));
    }

    Marshal.FreeHGlobal(unmanagedArray);

    Console.WriteLine("Done. Press Enter to continue.");
    Console.ReadLine();
}

Sub ReadWriteInt16()
    ' Allocate unmanaged memory. 
    Dim elementSize As Integer = 2
    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.WriteInt16(unmanagedArray, i * elementSize, CType(i + 1, Int16))
    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.ReadInt16(unmanagedArray, i * elementSize))
    Next i

    Marshal.FreeHGlobal(unmanagedArray)

    Console.WriteLine("Done. Press Enter to continue.")
    Console.ReadLine()
End Sub

L’exemple suivant montre comment utiliser la ReadInt16 méthode pour lire la valeur d’une variable non managée short .

using namespace System;
using namespace System::Runtime::InteropServices;



void main()
{
    // Create an unmanaged short.
    short myShort = 42;

    // Read the short as a managed Int16.
        Int16 ^ myManagedVal = Marshal::ReadInt16((IntPtr) &myShort);

    // Display the value to the console.
    Console::WriteLine(myManagedVal);
}

Remarques

ReadInt16 a un décalage implicite de 0. Cette méthode permet une interaction directe avec un tableau de style Int16 C non managé, éliminant ainsi 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

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

ReadInt16(IntPtr, Int32)

Source:

Marshal.cs

Lit un entier signé 16 bits à un offset donné dans la mémoire non managée.

public:
 static short ReadInt16(IntPtr ptr, int ofs);

public static short ReadInt16 (IntPtr ptr, int ofs);

static member ReadInt16 : nativeint * int -> int16

Public Shared Function ReadInt16 (ptr As IntPtr, ofs As Integer) As Short

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

Int16

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

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 ReadInt16 méthodes et WriteInt16 .

static void ReadWriteInt16()
{
    // Allocate unmanaged memory. 
    int elementSize = 2;
    IntPtr unmanagedArray = Marshal.AllocHGlobal(10 * elementSize);

    // Set the 10 elements of the C-style unmanagedArray
    for (int i = 0; i < 10; i++)
    {
        Marshal.WriteInt16(unmanagedArray, i * elementSize, ((Int16)(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.ReadInt16(unmanagedArray, i * elementSize));
    }

    Marshal.FreeHGlobal(unmanagedArray);

    Console.WriteLine("Done. Press Enter to continue.");
    Console.ReadLine();
}

Sub ReadWriteInt16()
    ' Allocate unmanaged memory. 
    Dim elementSize As Integer = 2
    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.WriteInt16(unmanagedArray, i * elementSize, CType(i + 1, Int16))
    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.ReadInt16(unmanagedArray, i * elementSize))
    Next i

    Marshal.FreeHGlobal(unmanagedArray)

    Console.WriteLine("Done. Press Enter to continue.")
    Console.ReadLine()
End Sub

L’exemple suivant montre comment utiliser la ReadInt16 méthode pour lire la valeur d’une variable non managée short .

using namespace System;
using namespace System::Runtime::InteropServices;

void main()
{
    // Create an unmanaged short pointer.
    short * myShort;
    short tmp = 42;
    // Initialize it to another value.
    myShort = &tmp;

    // Read value as a managed Int16.
    Int16 ^ myManagedVal = Marshal::ReadInt16((IntPtr) myShort, 0);

    // Display the value to the console.
    Console::WriteLine(myManagedVal);
}

Remarques

ReadInt16 permet une interaction directe avec un tableau signé 16 bits non managé, ce qui élimine les frais liés à la 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

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

ReadInt16(Object, Int32)

Source:

Marshal.CoreCLR.cs

Attention

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

Lit un entier signé 16 bits à un offset donné dans la mémoire non managée.

public:
 static short ReadInt16(System::Object ^ ptr, int ofs);

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

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

Public Shared Function ReadInt16 (ptr As Object, ofs As Integer) As Short

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

Int16

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

Attributs

ObsoleteAttribute

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

ReadInt16 permet une interaction directe avec un tableau signé 16 bits non managé, ce qui élimine les frais liés à la 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

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