Marshal.ReadIntPtr メソッド

定義

名前空間:

System.Runtime.InteropServices

アセンブリ:

System.Runtime.InteropServices.dll

アンマネージ メモリからプロセッサ ネイティブ サイズの整数を読み取ります。 アライメントされていないメモリ位置からの読み取りはサポートされています。

オーバーロード

ReadIntPtr(IntPtr, Int32)	アンマネージ メモリの指定されたオフセットからプロセッサ ネイティブ サイズの整数を読み取ります。
ReadIntPtr(Object, Int32)	古い. アンマネージ メモリからプロセッサ ネイティブ サイズの整数を読み取ります。
ReadIntPtr(IntPtr)	アンマネージ メモリからプロセッサ ネイティブ サイズの整数を読み取ります。

ReadIntPtr(IntPtr, Int32)

Source:

Marshal.cs

アンマネージ メモリの指定されたオフセットからプロセッサ ネイティブ サイズの整数を読み取ります。

public:
 static IntPtr ReadIntPtr(IntPtr ptr, int ofs);

public static IntPtr ReadIntPtr (IntPtr ptr, int ofs);

static member ReadIntPtr : nativeint * int -> nativeint

Public Shared Function ReadIntPtr (ptr As IntPtr, ofs As Integer) As IntPtr

パラメーター

ptr

IntPtr

nativeint

読み込み元となるアンマネージ メモリ内のベース アドレス。

ofs

Int32

読み取りの前に ptr パラメーターに追加される追加のバイト オフセット。

戻り値

IntPtr

nativeint

アンマネージ メモリの指定されたオフセットから読み取られた整数。

例外

AccessViolationException

ベース アドレス (ptr) にオフセット バイト (ofs) を足すと、null または無効なアドレスが生成されます。

例

次の例では、 メソッドと WriteIntPtr メソッドを使用してアンマネージド配列の読み取りと書き込みを行う方法をReadIntPtr示します。

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

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

    Marshal.FreeHGlobal(unmanagedArray);

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

Sub ReadWriteIntPtr()
    ' Allocate unmanaged memory.
    Dim elementSize As Integer = Marshal.SizeOf(GetType(IntPtr))
    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.WriteIntPtr(unmanagedArray, i * elementSize, CType(i + 1, IntPtr))
    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.ReadIntPtr(unmanagedArray, i * elementSize))
    Next i

    Marshal.FreeHGlobal(unmanagedArray)

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

注釈

ReadIntPtr を使用すると、アンマネージ C スタイル IntPtr の配列と直接やり取りできるため、アンマネージ配列全体 (を使用) Marshal.Copyを別のマネージド配列にコピーしてから要素の値を読み取る必要がなくなります。

アライメントされていないメモリ位置からの読み取りはサポートされています。

こちらもご覧ください

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

ReadIntPtr(Object, Int32)

Source:

Marshal.cs

注意事項

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

アンマネージ メモリからプロセッサ ネイティブ サイズの整数を読み取ります。

public:
 static IntPtr ReadIntPtr(System::Object ^ ptr, int ofs);

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

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

Public Shared Function ReadIntPtr (ptr As Object, ofs As Integer) As IntPtr

パラメーター

ptr

Object

ソース オブジェクトのアンマネージ メモリ内のベース アドレス。

ofs

Int32

読み取りの前に ptr パラメーターに追加される追加のバイト オフセット。

戻り値

IntPtr

nativeint

アンマネージ メモリの指定されたオフセットから読み取られた整数。

属性

ObsoleteAttribute

例外

AccessViolationException

ベース アドレス (ptr) にオフセット バイト (ofs) を足すと、null または無効なアドレスが生成されます。

ArgumentException

ptr が ArrayWithOffset オブジェクトです。 このメソッドは、ArrayWithOffset パラメーターを受け入れません。

注釈

ReadIntPtr を使用すると、アンマネージ C スタイル IntPtr の配列と直接やり取りできるため、アンマネージ配列全体 (を使用) Marshal.Copyを別のマネージド配列にコピーしてから要素の値を読み取る必要がなくなります。

アライメントされていないメモリ位置からの読み取りはサポートされています。

こちらもご覧ください

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

ReadIntPtr(IntPtr)

Source:

Marshal.cs

アンマネージ メモリからプロセッサ ネイティブ サイズの整数を読み取ります。

public:
 static IntPtr ReadIntPtr(IntPtr ptr);

public static IntPtr ReadIntPtr (IntPtr ptr);

static member ReadIntPtr : nativeint -> nativeint

Public Shared Function ReadIntPtr (ptr As IntPtr) As IntPtr

パラメーター

ptr

IntPtr

nativeint

読み込み元となるアンマネージ メモリ内のアドレス。

戻り値

IntPtr

nativeint

アンマネージ メモリから読み取られた整数。 32 ビット コンピューター上では 32 ビット整数が返され、64 ビット コンピューター上では 64 ビット整数が返されます。

例外

AccessViolationException

ptr が認識された形式ではありません。

または

ptr は null です。

または

ptr が無効です。

例

次の例では、 メソッドと WriteIntPtr メソッドを使用してアンマネージド配列の読み取りと書き込みを行う方法をReadIntPtr示します。

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

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

    Marshal.FreeHGlobal(unmanagedArray);

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

Sub ReadWriteIntPtr()
    ' Allocate unmanaged memory.
    Dim elementSize As Integer = Marshal.SizeOf(GetType(IntPtr))
    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.WriteIntPtr(unmanagedArray, i * elementSize, CType(i + 1, IntPtr))
    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.ReadIntPtr(unmanagedArray, i * elementSize))
    Next i

    Marshal.FreeHGlobal(unmanagedArray)

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

注釈

ReadIntPtr の暗黙的なオフセットは 0 です。 このメソッドを使用すると、アンマネージ C スタイル IntPtr の配列と直接やり取りできるため、アンマネージ配列全体 (を使用) Marshal.Copyを別のマネージド配列にコピーしてから要素値を読み取る必要がなくなります。

アライメントされていないメモリ位置からの読み取りはサポートされています。

こちらもご覧ください

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