Marshal.ReadIntPtr メソッド

リファレンス

定義

名前空間:: System.Runtime.InteropServices

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

アセンブリ:: mscorlib.dll

アセンブリ:: netstandard.dll

重要

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

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

オーバーロード

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

ReadIntPtr(IntPtr, Int32)

ソース:: Marshal.cs

ソース:: Marshal.cs

ソース:: Marshal.cs

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

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 または無効なアドレスが生成されます。

例

次の例では、メソッドと 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を別のマネージド配列にコピーしてから要素の値を読み取る必要がなくなります。

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

こちらもご覧ください

適用対象

ReadIntPtr(Object, Int32)

ソース:: Marshal.cs

ソース:: Marshal.cs

ソース:: 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.")]
[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);

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.")>]
[<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

static member ReadIntPtr : obj * int -> nativeint

[<System.Security.SecurityCritical>]
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)

ソース:: Marshal.cs

ソース:: Marshal.cs

ソース:: Marshal.cs

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

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 が無効です。

例

次の例では、メソッドと 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)

適用対象

次の方法で共有

Marshal.ReadIntPtr メソッド

定義

オーバーロード

ReadIntPtr(IntPtr, Int32)

パラメーター

戻り値

例外

例

注釈

こちらもご覧ください

適用対象

ReadIntPtr(Object, Int32)

パラメーター

戻り値

例外

注釈

こちらもご覧ください

適用対象

ReadIntPtr(IntPtr)

パラメーター

戻り値

例外

例

注釈

こちらもご覧ください

適用対象

その他のリソース