Marshal.ReadIntPtr メソッド

定義

名前空間:: System.Runtime.InteropServices

アセンブリ:: mscorlib.dll, System.Runtime.InteropServices.dll

アセンブリ:: mscorlib.dll

アセンブリ:: System.Runtime.InteropServices.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

オーバーロード

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

ReadIntPtr(IntPtr, Int32)

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

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

[System.Security.SecurityCritical]
public static IntPtr ReadIntPtr(IntPtr ptr, int ofs);

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

[<System.Security.SecurityCritical>]
static member ReadIntPtr : nativeint * int -> nativeint

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

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

属性: SecurityCriticalAttribute

例外

AccessViolationException

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

例

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

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 を使用) を別のマネージド配列にコピーする手間が省けます。

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

こちらもご覧ください

適用対象

ReadIntPtr(Object, Int32)

注意事項

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.")]
[System.Security.SecurityCritical]
public static IntPtr ReadIntPtr(object ptr, int ofs);

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

[System.Security.SecurityCritical]
public static IntPtr ReadIntPtr(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.")>]
[<System.Security.SecurityCritical>]
static member ReadIntPtr : obj * int -> nativeint

static member ReadIntPtr : obj * int -> nativeint

[<System.Security.SecurityCritical>]
static member ReadIntPtr : obj * int -> nativeint

[<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 SecurityCriticalAttribute

例外

AccessViolationException

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

ArgumentException

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

注釈

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

こちらもご覧ください

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

適用対象

ReadIntPtr(IntPtr)

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

public:
 static IntPtr ReadIntPtr(IntPtr ptr);

[System.Security.SecurityCritical]
public static IntPtr ReadIntPtr(IntPtr ptr);

public static IntPtr ReadIntPtr(IntPtr ptr);

[<System.Security.SecurityCritical>]
static member ReadIntPtr : nativeint -> nativeint

static member ReadIntPtr : nativeint -> nativeint

Public Shared Function ReadIntPtr (ptr As IntPtr) As IntPtr

パラメーター

ptr: IntPtr
nativeint

読み取り元のアンマネージメモリ内のアドレス。

返品

IntPtr

nativeint

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

属性: SecurityCriticalAttribute

例外

AccessViolationException

ptr が認識されない形式です。

-または-

ptr は nullです。

-または-

ptr が無効です。

例

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

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)

適用対象

フィードバック

このページはお役に立ちましたか?