Marshal.PtrToStructure メソッド

定義

名前空間:

System.Runtime.InteropServices

アセンブリ:

System.Runtime.InteropServices.dll

アンマネージド メモリ ブロックからマネージド オブジェクトにデータをマーシャリングします。

オーバーロード

PtrToStructure(IntPtr, Object)	アンマネージド メモリ ブロックからマネージド オブジェクトにデータをマーシャリングします。
PtrToStructure(IntPtr, Type)	アンマネージド メモリ ブロックから、指定した型の、新しく割り当てられたマネージド オブジェクトにデータをマーシャリングします。
PtrToStructure<T>(IntPtr)	アンマネージド メモリ ブロックから、ジェネリック型パラメーターによって指定された型の、新しく割り当てられたマネージド オブジェクトにデータをマーシャリングします。
PtrToStructure<T>(IntPtr, T)	アンマネージド メモリ ブロックから、指定した型のマネージド オブジェクトにデータをマーシャリングします。

PtrToStructure(IntPtr, Object)

ソース:

Marshal.cs

アンマネージド メモリ ブロックからマネージド オブジェクトにデータをマーシャリングします。

C#

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

パラメーター

ptr

IntPtr

アンマネージ メモリ ブロックへのポインター。

structure

Object

データのコピー先のオブジェクト。 これは、書式指定クラスのインスタンスである必要があります。

例外

ArgumentException

構造体のレイアウトがシーケンシャルまたは明示的ではありません。

または

構造体は、ボックス化された値型です。

注釈

PtrToStructure は、多くの場合、構造体パラメーターが値として表される場合に、COM 相互運用機能とプラットフォーム呼び出しで System.IntPtr 必要になります。 このオーバーロード メソッドを値型と共に使用することはできません。 パラメーターが ptr と等しいIntPtr.Zeronull場合は、 が返されます。

PtrToStructure(IntPtr, Type)

ソース:

Marshal.cs

アンマネージド メモリ ブロックから、指定した型の、新しく割り当てられたマネージド オブジェクトにデータをマーシャリングします。

C#

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

パラメーター

ptr

IntPtr

アンマネージ メモリ ブロックへのポインター。

structureType

Type

作成するオブジェクトの型。 このオブジェクトは、書式指定クラスまたは構造体を表す必要があります。

戻り値

Object

ptr パラメーターが指すデータを格納しているマネージド オブジェクト。

例外

ArgumentException

structureType パラメーターのレイアウトがシーケンシャルまたは明示的ではありません。

または

structureType パラメーターがジェネリック型定義です。

ArgumentNullException

structureType が nullです。

MissingMethodException

structureType で指定したクラスに、アクセスできるパラメーターなしのコンストラクターがありません。

例

次の例では、マネージド構造体を作成し、アンマネージド メモリに転送してから、 メソッドを使用して PtrToStructure マネージド メモリに転送します。

C#

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

次の例では、 メソッドを使用してアンマネージ メモリ ブロックをマネージド構造体にマーシャリングする方法を PtrToStructure 示します。

重要

このコードは、32 ビットコンパイルを前提としています。 64 ビット コンパイラを使用する前に、 を にIntPtr.ToInt64置き換えますIntPtr.ToInt32。

C#

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

注釈

PtrToStructure は、多くの場合、構造体パラメーターが値として表される場合に、COM 相互運用機能とプラットフォーム呼び出しで System.IntPtr 必要になります。 このオーバーロード メソッドに値型を渡すことができます。 この場合、返されるオブジェクトはボックス化されたインスタンスです。 パラメーターが ptr と等しいIntPtr.Zeronull場合は、 が返されます。

こちらもご覧ください

• GetTypeAttr(IntPtr)

PtrToStructure<T>(IntPtr)

ソース:

Marshal.cs

アンマネージド メモリ ブロックから、ジェネリック型パラメーターによって指定された型の、新しく割り当てられたマネージド オブジェクトにデータをマーシャリングします。

C#

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

型パラメーター

T

データをコピーする先のオブジェクトの型。 これは、書式指定クラスまたは構造体である必要があります。

パラメーター

ptr

IntPtr

アンマネージ メモリ ブロックへのポインター。

戻り値

T

ptr パラメーターが指すデータを格納しているマネージド オブジェクト。

例外

ArgumentException

T のレイアウトがシーケンシャルまたは明示的ではありません。

MissingMethodException

T で指定したクラスに、アクセスできるパラメーターなしのコンストラクターがありません。

注釈

PtrToStructure<T>(IntPtr) は、多くの場合、構造体パラメーターが値として表される場合に、COM 相互運用機能とプラットフォーム呼び出しで System.IntPtr 必要になります。 このメソッド のオーバーロードに値型を渡すことができます。 パラメーターが ptr と等しく IntPtr.Zero 、 T 参照型の場合は が null 返されます。 が とIntPtr.Zero等しい場合、 T が値型である場合ptrは、 NullReferenceException がスローされます。

PtrToStructure<T>(IntPtr, T)

ソース:

Marshal.cs

アンマネージド メモリ ブロックから、指定した型のマネージド オブジェクトにデータをマーシャリングします。

C#

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

型パラメーター

T

structure の型。 書式が設定されたクラスである必要があります。

パラメーター

ptr

IntPtr

アンマネージ メモリ ブロックへのポインター。

structure

T

データのコピー先のオブジェクト。

例外

ArgumentException

構造体のレイアウトがシーケンシャルまたは明示的ではありません。

注釈

PtrToStructure<T>(IntPtr, T) は、多くの場合、構造体パラメーターが値として表される場合に、COM 相互運用機能とプラットフォーム呼び出しで IntPtr 必要になります。 このメソッド オーバーロードは、値型では使用できません。 パラメーターが ptr と等しく IntPtr.Zero 、 T 参照型の場合は が null 返されます。 が とIntPtr.Zero等しい場合、 T が値型である場合ptrは、 NullReferenceException がスローされます。