Marshal.PtrToStructure Metodo

Definizione

Spazio dei nomi:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

Effettua il marshalling di dati da un blocco di memoria non gestita a un oggetto gestito.

Overload

PtrToStructure(IntPtr, Object)	Effettua il marshalling di dati da un blocco di memoria non gestita a un oggetto gestito.
PtrToStructure(IntPtr, Type)	Effettua il marshalling di dati da un blocco di memoria non gestita a un oggetto gestito appena allocato del tipo specificato.
PtrToStructure<T>(IntPtr)	Effettua il marshalling di dati da un blocco di memoria non gestita a un oggetto gestito appena allocato del tipo specificato per un parametro del tipo generico.
PtrToStructure<T>(IntPtr, T)	Effettua il marshalling di dati da un blocco di memoria non gestita a un oggetto gestito di un tipo specificato.

PtrToStructure(IntPtr, Object)

Origine:

Marshal.cs

Effettua il marshalling di dati da un blocco di memoria non gestita a un oggetto gestito.

public:
 static void PtrToStructure(IntPtr ptr, System::Object ^ structure);

public static void PtrToStructure (IntPtr ptr, object structure);

static member PtrToStructure : nativeint * obj -> unit

Public Shared Sub PtrToStructure (ptr As IntPtr, structure As Object)

Parametri

ptr

IntPtr

nativeint

Puntatore a un blocco di memoria non gestita.

structure

Object

Oggetto nel quale devono essere copiati i dati. Deve essere un'istanza di una classe formattata.

Eccezioni

ArgumentException

Il layout della struttura non è sequenziale o esplicito.

-oppure-

La struttura è un tipo valore boxed.

Commenti

PtrToStructure è spesso necessario nell'interoperabilità COM e nella piattaforma richiamano quando i parametri della struttura vengono rappresentati come System.IntPtr valore. Non è possibile usare questo metodo di overload con tipi di valore. Se il ptr parametro è uguale IntPtr.Zeroa , null verrà restituito.

PtrToStructure(IntPtr, Type)

Origine:

Marshal.cs

Effettua il marshalling di dati da un blocco di memoria non gestita a un oggetto gestito appena allocato del tipo specificato.

public:
 static System::Object ^ PtrToStructure(IntPtr ptr, Type ^ structureType);

public static object? PtrToStructure (IntPtr ptr, Type structureType);

static member PtrToStructure : nativeint * Type -> obj

Public Shared Function PtrToStructure (ptr As IntPtr, structureType As Type) As Object

Parametri

ptr

IntPtr

nativeint

Puntatore a un blocco di memoria non gestita.

structureType

Type

Tipo di oggetto da creare. Questo oggetto deve rappresentare una classe formattata o una struttura.

Restituisce

Object

Oggetto gestito contenente i dati a cui punta il parametro ptr.

Eccezioni

ArgumentException

Il layout del parametro structureType non è sequenziale o esplicito.

-oppure-

Il parametro structureType è una definizione di tipo generico.

ArgumentNullException

structureType è null.

MissingMethodException

La classe specificata da structureType non ha un costruttore senza parametri accessibile.

Esempio

L'esempio seguente crea una struttura gestita, lo trasferisce alla memoria non gestita e quindi lo trasferisce alla memoria gestita usando il PtrToStructure metodo .

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

Nell'esempio seguente viene illustrato come eseguire il marshalling di un blocco non gestito di memoria in una struttura gestita usando il PtrToStructure metodo .

Importante

Questo codice presuppone la compilazione a 32 bit. Prima di usare un compilatore a 64 bit, sostituire IntPtr.ToInt32 con IntPtr.ToInt64.

[StructLayout(LayoutKind::Sequential)]
ref class INNER
{
public:
    [MarshalAs(UnmanagedType::ByValTStr,SizeConst=10)]
    String^ field;

    INNER()
    {
        field = "Test";
    }
};

[StructLayout(LayoutKind::Sequential)]
value struct OUTER
{
public:
    [MarshalAs(UnmanagedType::ByValTStr,SizeConst=10)]
    String^ field;

    [MarshalAs(UnmanagedType::ByValArray,SizeConst=100)]
    array<Byte>^ inner;
};

[DllImport("SomeTestDLL.dll")]
static void CallTest(OUTER^ outerStructurePointer);

void static Work()
{
    OUTER outerStructure;
    array<INNER^>^ innerArray = gcnew array<INNER^>(10);
    INNER^ innerStructure = gcnew INNER;
    int structSize = Marshal::SizeOf(innerStructure);
    int size = innerArray->Length * structSize;
    outerStructure.inner = gcnew array<Byte>(size);

    try
    {
        CallTest(outerStructure);
    }
    catch (SystemException^ ex) 
    {
        Console::WriteLine(ex->Message);
    }

    IntPtr buffer = Marshal::AllocCoTaskMem(structSize * 10);
    Marshal::Copy(outerStructure.inner, 0, buffer, structSize * 10);
    int currentOffset = 0;
    for (int i = 0; i < 10; i++)
    {
        innerArray[i] = safe_cast<INNER^>(Marshal::PtrToStructure(
            IntPtr(buffer.ToInt32() + currentOffset),
            INNER::typeid));
        currentOffset += structSize;
    }
    Console::WriteLine(outerStructure.field);
    Marshal::FreeCoTaskMem(buffer);
}

        [StructLayout(LayoutKind.Sequential)]

        public class  INNER

        {

            [MarshalAs(UnmanagedType.ByValTStr, SizeConst =  10)]

            public string field1 = "Test";
        }	

        [StructLayout(LayoutKind.Sequential)]

        public struct OUTER

        {

            [MarshalAs(UnmanagedType.ByValTStr, SizeConst =  10)]

            public string field1;

            [MarshalAs(UnmanagedType.ByValArray, SizeConst =  100)]

            public byte[] inner;
        }
        [DllImport(@"SomeTestDLL.dll")]

        public static extern void CallTest( ref OUTER po);
        static void Main(string[] args)

        {

            OUTER ed = new OUTER();

            INNER[] inn=new INNER[10];

            INNER test = new INNER();

            int iStructSize = Marshal.SizeOf(test);
            int sz =inn.Length * iStructSize;

            ed.inner = new byte[sz];
            try

            {

                CallTest( ref ed);
            }

            catch(Exception e)

            {

                Console.WriteLine(e.Message);
            }

            IntPtr buffer = Marshal.AllocCoTaskMem(iStructSize*10);

            Marshal.Copy(ed.inner,0,buffer,iStructSize*10);
            int iCurOffset = 0;

            for(int i=0;i<10;i++)

            {
                inn[i] = (INNER)Marshal.PtrToStructure(new
IntPtr(buffer.ToInt32()+iCurOffset),typeof(INNER) );

                iCurOffset += iStructSize;
            }

            Console.WriteLine(ed.field1);

            Marshal.FreeCoTaskMem(buffer);
        }

Commenti

PtrToStructure è spesso necessario nell'interoperabilità COM e nella piattaforma richiamano quando i parametri della struttura vengono rappresentati come System.IntPtr valore. È possibile passare un tipo di valore a questo metodo di overload. In questo caso, l'oggetto restituito è un'istanza boxed. Se il ptr parametro è uguale IntPtr.Zeroa , null verrà restituito.

Vedi anche

• GetTypeAttr(IntPtr)

PtrToStructure<T>(IntPtr)

Origine:

Marshal.cs

Effettua il marshalling di dati da un blocco di memoria non gestita a un oggetto gestito appena allocato del tipo specificato per un parametro del tipo generico.

public:
generic <typename T>
 static T PtrToStructure(IntPtr ptr);

public static T? PtrToStructure<T> (IntPtr ptr);

static member PtrToStructure : nativeint -> 'T

Public Shared Function PtrToStructure(Of T) (ptr As IntPtr) As T

Parametri di tipo

T

Tipo dell'oggetto nel quale devono essere copiati i dati. Questo deve rappresentare una classe formattata o una struttura.

Parametri

ptr

IntPtr

nativeint

Puntatore a un blocco di memoria non gestita.

Restituisce

T

Oggetto gestito che contiene i dati a cui punta il parametro ptr.

Eccezioni

ArgumentException

Il layout di T non è sequenziale o esplicito.

MissingMethodException

La classe specificata da T non ha un costruttore senza parametri accessibile.

Commenti

PtrToStructure<T>(IntPtr) è spesso necessario nell'interoperabilità COM e nella piattaforma richiamano quando i parametri della struttura vengono rappresentati come System.IntPtr valori. È possibile passare un tipo di valore all'overload del metodo. Se il ptr parametro è uguale IntPtr.Zero e T è un tipo di riferimento, null viene restituito. Se ptr è uguale IntPtr.Zero a e T è un tipo di valore, viene generato un NullReferenceException oggetto .

PtrToStructure<T>(IntPtr, T)

Origine:

Marshal.cs

Effettua il marshalling di dati da un blocco di memoria non gestita a un oggetto gestito di un tipo specificato.

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

public static void PtrToStructure<T> (IntPtr ptr, T structure);

static member PtrToStructure : nativeint * 'T -> unit

Public Shared Sub PtrToStructure(Of T) (ptr As IntPtr, structure As T)

Parametri di tipo

T

Tipo di structure. Deve essere una classe formattata.

Parametri

ptr

IntPtr

nativeint

Puntatore a un blocco di memoria non gestita.

structure

T

Oggetto nel quale devono essere copiati i dati.

Eccezioni

ArgumentException

Il layout della struttura non è sequenziale o esplicito.

Commenti

PtrToStructure<T>(IntPtr, T) è spesso necessario nell'interoperabilità COM e nella piattaforma richiamano quando i parametri della struttura vengono rappresentati come IntPtr valori. Non è possibile usare questo overload del metodo con tipi di valore. Se il ptr parametro è uguale IntPtr.Zero e T è un tipo di riferimento, null viene restituito. Se ptr è uguale IntPtr.Zero a e T è un tipo di valore, viene generato un NullReferenceException oggetto .