Marshal.PtrToStructure Methode

Quelle:

Marshal.cs

Quelle:

Marshal.cs

Quelle:

Marshal.cs

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

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

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

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

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

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

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

static member PtrToStructure : nativeint * obj -> unit

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

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

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

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

Parameter

Attribute

ObsoleteAttribute SecurityCriticalAttribute ComVisibleAttribute

Ausnahmen

Hinweise

PtrToStructure ist häufig in COM-Interop- und Plattformaufrufen erforderlich, wenn Strukturparameter als Wert System.IntPtr dargestellt werden. Sie können diese Überladungsmethode nicht mit Werttypen verwenden. Wenn der ptr Parameter gleich IntPtr.Zeroist, null wird zurückgegeben.

Quelle:

Marshal.cs

Quelle:

Marshal.cs

Quelle:

Marshal.cs

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

[System.Obsolete("PtrToStructure(IntPtr, Type) may be unavailable in future releases. Instead, use PtrToStructure<T>(IntPtr). For more info, go to http://go.microsoft.com/fwlink/?LinkID=296513")]
[System.Security.SecurityCritical]
public static object PtrToStructure (IntPtr ptr, Type structureType);

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

[System.Security.SecurityCritical]
public static object PtrToStructure (IntPtr ptr, Type structureType);

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

[System.Runtime.InteropServices.ComVisible(true)]
public static object PtrToStructure (IntPtr ptr, Type structureType);

[System.Security.SecurityCritical]
[System.Runtime.InteropServices.ComVisible(true)]
public static object PtrToStructure (IntPtr ptr, Type structureType);

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

static member PtrToStructure : nativeint * Type -> obj

[<System.Security.SecurityCritical>]
static member PtrToStructure : nativeint * Type -> obj

[<System.Runtime.InteropServices.ComVisible(true)>]
static member PtrToStructure : nativeint * Type -> obj

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

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

Parameter

Gibt zurück

Ein verwaltetes Objekt mit Daten, auf die der ptr-Parameter zeigt.

Attribute

ObsoleteAttribute SecurityCriticalAttribute ComVisibleAttribute

Ausnahmen

Beispiele

Im folgenden Beispiel wird eine verwaltete Struktur erstellt, in den nicht verwalteten Speicher übertragen und dann mithilfe der -Methode wieder in den PtrToStructure verwalteten Arbeitsspeicher übertragen.

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

Im folgenden Beispiel wird veranschaulicht, wie ein nicht verwalteter Speicherblock mithilfe der -Methode in eine verwaltete Struktur gemarshallt PtrToStructure wird.

[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);
        }

Hinweise

PtrToStructure ist häufig in COM-Interop- und Plattformaufrufen erforderlich, wenn Strukturparameter als Wert System.IntPtr dargestellt werden. Sie können einen Werttyp an diese Überladungsmethode übergeben. In diesem Fall ist das zurückgegebene Objekt ein geschachteltes instance. Wenn der ptr Parameter gleich IntPtr.Zeroist, null wird zurückgegeben.

Weitere Informationen

• GetTypeAttr(IntPtr)

Quelle:

Marshal.cs

Quelle:

Marshal.cs

Quelle:

Marshal.cs

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

[System.Security.SecurityCritical]
public static T PtrToStructure<T> (IntPtr ptr);

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

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

[<System.Security.SecurityCritical>]
static member PtrToStructure : nativeint -> 'T

static member PtrToStructure : nativeint -> 'T

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

Typparameter

Parameter

Gibt zurück

Ein verwaltetes Objekt mit Daten, auf die der ptr-Parameter zeigt.

Attribute

SecurityCriticalAttribute

Ausnahmen

Hinweise

PtrToStructure<T>(IntPtr) ist häufig in COM-Interop- und Plattformaufrufen erforderlich, wenn Strukturparameter als System.IntPtr Werte dargestellt werden. Sie können einen Werttyp an diese Methodenüberladung übergeben. Wenn der ptr Parameter gleich IntPtr.Zero ist und T ein Verweistyp ist, null wird zurückgegeben. Wenn ptr gleich IntPtr.Zero ist und T ein Werttyp ist, wird ein NullReferenceException ausgelöst.

Quelle:

Marshal.cs

Quelle:

Marshal.cs

Quelle:

Marshal.cs

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

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

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

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

static member PtrToStructure : nativeint * 'T -> unit

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

Typparameter

Parameter

Attribute

SecurityCriticalAttribute

Ausnahmen

Hinweise

PtrToStructure<T>(IntPtr, T) ist häufig in COM-Interop- und Plattformaufrufen erforderlich, wenn Strukturparameter als IntPtr Werte dargestellt werden. Sie können diese Methodenüberladung nicht mit Werttypen verwenden. Wenn der ptr Parameter gleich IntPtr.Zero ist und T ein Verweistyp ist, null wird zurückgegeben. Wenn ptr gleich IntPtr.Zero ist und T ein Werttyp ist, wird ein NullReferenceException ausgelöst.