Marshal.StructureToPtr Méthode

Source:

Marshal.cs

Source:

Marshal.cs

Source:

Marshal.CoreCLR.cs

public:
 static void StructureToPtr(System::Object ^ structure, IntPtr ptr, bool fDeleteOld);

[System.Obsolete("StructureToPtr(Object, IntPtr, Boolean) may be unavailable in future releases. Instead, use StructureToPtr<T>(T, IntPtr, Boolean). For more info, go to http://go.microsoft.com/fwlink/?LinkID=296516")]
[System.Security.SecurityCritical]
public static void StructureToPtr (object structure, IntPtr ptr, bool fDeleteOld);

public static void StructureToPtr (object structure, IntPtr ptr, bool fDeleteOld);

[System.Security.SecurityCritical]
public static void StructureToPtr (object structure, IntPtr ptr, bool fDeleteOld);

[System.Runtime.InteropServices.ComVisible(true)]
public static void StructureToPtr (object structure, IntPtr ptr, bool fDeleteOld);

[System.Security.SecurityCritical]
[System.Runtime.InteropServices.ComVisible(true)]
public static void StructureToPtr (object structure, IntPtr ptr, bool fDeleteOld);

[<System.Obsolete("StructureToPtr(Object, IntPtr, Boolean) may be unavailable in future releases. Instead, use StructureToPtr<T>(T, IntPtr, Boolean). For more info, go to http://go.microsoft.com/fwlink/?LinkID=296516")>]
[<System.Security.SecurityCritical>]
static member StructureToPtr : obj * nativeint * bool -> unit

static member StructureToPtr : obj * nativeint * bool -> unit

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

[<System.Runtime.InteropServices.ComVisible(true)>]
static member StructureToPtr : obj * nativeint * bool -> unit

[<System.Security.SecurityCritical>]
[<System.Runtime.InteropServices.ComVisible(true)>]
static member StructureToPtr : obj * nativeint * bool -> unit

Public Shared Sub StructureToPtr (structure As Object, ptr As IntPtr, fDeleteOld As Boolean)

Paramètres

Attributs

ObsoleteAttribute SecurityCriticalAttribute ComVisibleAttribute

Exceptions

Exemples

L’exemple suivant crée une structure managée, la transfère à la mémoire non managée à l’aide de la StructureToPtr méthode, puis la transfère à la mémoire managée à l’aide de la PtrToStructure méthode .

using System;
using System.Runtime.InteropServices;

public struct Point
{
    public int x;
    public int y;
}

class Example
{

    static void Main()
    {

        // Create a point struct.
        Point p;
        p.x = 1;
        p.y = 1;

        Console.WriteLine("The value of first point is " + p.x + " and " + p.y + ".");

        // Initialize unmanged memory to hold the struct.
        IntPtr pnt = Marshal.AllocHGlobal(Marshal.SizeOf(p));

        try
        {

            // Copy the struct to unmanaged memory.
            Marshal.StructureToPtr(p, pnt, false);

            // Create another point.
            Point anotherP;

            // Set this Point to the value of the
            // Point in unmanaged memory.
            anotherP = (Point)Marshal.PtrToStructure(pnt, typeof(Point));

            Console.WriteLine("The value of new point is " + anotherP.x + " and " + anotherP.y + ".");
        }
        finally
        {
            // Free the unmanaged memory.
            Marshal.FreeHGlobal(pnt);
        }
    }
}

Imports System.Runtime.InteropServices



Public Structure Point
    Public x As Integer
    Public y As Integer
End Structure


Module Example


    Sub Main()

        ' Create a point struct.
        Dim p As Point
        p.x = 1
        p.y = 1

        Console.WriteLine("The value of first point is " + p.x.ToString + " and " + p.y.ToString + ".")

        ' Initialize unmanged memory to hold the struct.
        Dim pnt As IntPtr = Marshal.AllocHGlobal(Marshal.SizeOf(p))

        Try

            ' Copy the struct to unmanaged memory.
            Marshal.StructureToPtr(p, pnt, False)

            ' Create another point.
            Dim anotherP As Point

            ' Set this Point to the value of the 
            ' Point in unmanaged memory. 
            anotherP = CType(Marshal.PtrToStructure(pnt, GetType(Point)), Point)

            Console.WriteLine("The value of new point is " + anotherP.x.ToString + " and " + anotherP.y.ToString + ".")

        Finally
            ' Free the unmanaged memory.
            Marshal.FreeHGlobal(pnt)
        End Try

    End Sub
End Module

Remarques

Si structure est un type de valeur, il peut être boxé ou unboxed. S’il est en boîte, il est déballé avant la copie.

Une classe mise en forme est un type de référence dont la disposition est spécifiée par l’attribut, sous la StructLayoutAttribute forme LayoutKind.Explicit ou LayoutKind.Sequential.

StructureToPtr copie le contenu de structure dans le bloc de mémoire pré-alloué vers lequel pointe le ptr paramètre. Si structure contient des types de référence qui marshalent vers des pointeurs d’interface COM (interfaces, classes sans disposition et System.Object), les objets managés sont maintenus en vie avec le nombre de références. Tous les autres types de référence (par exemple, les chaînes et les tableaux) sont marshalés en copies. Pour libérer ces objets managés ou non managés, vous devez appeler la Marshal.DestroyStructure méthode avant de libérer le bloc de mémoire.

Si vous utilisez la StructureToPtr méthode pour fDeleteOld copier ultérieurement un autre instance dans le bloc de mémoire, spécifiez true pour pour supprimer le nombre de références pour les types de référence dans le instance précédent. Sinon, les types de référence managés et les copies non managées sont effectivement divulgués.

Le modèle global d’utilisation StructureToPtr est le suivant :

1. Lors du premier appel à la méthode après l’allocation StructureToPtr d’un bloc de mémoire, fDeleteOld doit être false, car il n’y a pas de contenu à effacer.

   Important

   Spécifiez true uniquement si fDeleteOld le bloc contient des données valides.

2. Si vous copiez un autre instance dans le bloc de mémoire et que l’objet contient des types de référence, fDeleteOld doit être true pour libérer les types de référence dans l’ancien contenu.

3. Si l’objet contient des types de référence, vous devez appeler la DestroyStructure méthode avant de libérer le bloc de mémoire.

Voir aussi

• DestroyStructure(IntPtr, Type)
• GCHandle

Source:

Marshal.cs

Source:

Marshal.cs

Source:

Marshal.cs

public:
generic <typename T>
 static void StructureToPtr(T structure, IntPtr ptr, bool fDeleteOld);

[System.Security.SecurityCritical]
public static void StructureToPtr<T> (T structure, IntPtr ptr, bool fDeleteOld);

public static void StructureToPtr<T> (T structure, IntPtr ptr, bool fDeleteOld);

[<System.Security.SecurityCritical>]
static member StructureToPtr : 'T * nativeint * bool -> unit

static member StructureToPtr : 'T * nativeint * bool -> unit

Public Shared Sub StructureToPtr(Of T) (structure As T, ptr As IntPtr, fDeleteOld As Boolean)

Paramètres de type

Paramètres

Attributs

SecurityCriticalAttribute

Exceptions

Remarques

Une classe mise en forme est un type de référence dont la disposition est spécifiée par l’attribut, sous la StructLayoutAttribute forme LayoutKind.Explicit ou LayoutKind.Sequential.

StructureToPtr<T>(T, IntPtr, Boolean) copie le contenu de structure dans le bloc de mémoire pré-alloué vers lequel pointe le ptr paramètre. Si structure contient des types de référence qui marshalent vers des pointeurs d’interface COM (interfaces, classes sans disposition et System.Object), les objets managés sont maintenus en vie avec le nombre de références. Tous les autres types de référence (par exemple, les chaînes et les tableaux) sont marshalés en copies. Pour libérer ces objets managés ou non managés, vous devez appeler la DestroyStructure<T>(IntPtr) méthode avant de libérer le bloc de mémoire.

Si vous utilisez la StructureToPtr<T>(T, IntPtr, Boolean) méthode pour fDeleteOld copier ultérieurement un autre instance dans le bloc de mémoire, spécifiez true pour pour supprimer le nombre de références pour les types de référence dans le instance précédent. Sinon, les types de référence managés et les copies non managées sont effectivement divulgués.

Le modèle global d’utilisation StructureToPtr<T>(T, IntPtr, Boolean) est le suivant :

1. Lors du premier appel à la méthode après l’allocation StructureToPtr d’un bloc de mémoire, fDeleteOld doit être false, car il n’y a pas de contenu à effacer.

   Important

   Spécifiez true uniquement si fDeleteOld le bloc contient des données valides.

2. Si vous copiez un autre instance dans le bloc de mémoire et que l’objet contient des types de référence, fDeleteOld doit être true pour libérer les types de référence dans l’ancien contenu.

3. Si l’objet contient des types de référence, vous devez appeler la DestroyStructure méthode avant de libérer le bloc de mémoire.

Voir aussi

• DestroyStructure<T>(IntPtr)
• GCHandle