Marshal.WriteIntPtr メソッド

リファレンス

定義

名前空間:: System.Runtime.InteropServices

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

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

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

アセンブリ:: mscorlib.dll

アセンブリ:: netstandard.dll

重要

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

アンマネージメモリにプロセッサネイティブサイズの整数値を書き込みます。 32 ビットシステム上では 32 ビット整数が書き込まれ、64 ビットシステム上では 64 ビット整数が書き込まれます。アライメントされていないメモリ位置への書き込みはサポートされています。

オーバーロード

WriteIntPtr(IntPtr, IntPtr)	アンマネージメモリにプロセッサネイティブサイズの整数を書き込みます。
WriteIntPtr(IntPtr, Int32, IntPtr)	アンマネージメモリの指定されたオフセット位置にプロセッサネイティブサイズの整数値を書き込みます。
WriteIntPtr(Object, Int32, IntPtr)	古い. アンマネージメモリにプロセッサネイティブサイズの整数を書き込みます。

WriteIntPtr(IntPtr, IntPtr)

ソース:: Marshal.cs

ソース:: Marshal.cs

ソース:: Marshal.cs

アンマネージメモリにプロセッサネイティブサイズの整数を書き込みます。

public:
 static void WriteIntPtr(IntPtr ptr, IntPtr val);

[System.Security.SecurityCritical]
public static void WriteIntPtr(IntPtr ptr, IntPtr val);

public static void WriteIntPtr(IntPtr ptr, IntPtr val);

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

static member WriteIntPtr : nativeint * nativeint -> unit

Public Shared Sub WriteIntPtr (ptr As IntPtr, val As IntPtr)

パラメーター

ptr: IntPtr

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

val: IntPtr

書き込む値。

属性: 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

注釈

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

アライメントされていないメモリ位置への書き込みはサポートされています。

こちらもご覧ください

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

適用対象

.NET 9 およびその他のバージョン

製品	バージョン
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

WriteIntPtr(IntPtr, Int32, IntPtr)

ソース:: Marshal.cs

ソース:: Marshal.cs

ソース:: Marshal.cs

アンマネージメモリの指定されたオフセット位置にプロセッサネイティブサイズの整数値を書き込みます。

public:
 static void WriteIntPtr(IntPtr ptr, int ofs, IntPtr val);

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

public static void WriteIntPtr(IntPtr ptr, int ofs, IntPtr val);

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

static member WriteIntPtr : nativeint * int * nativeint -> unit

Public Shared Sub WriteIntPtr (ptr As IntPtr, ofs As Integer, val As IntPtr)

パラメーター

ptr: IntPtr

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

ofs: Int32

書き込みの前に ptr パラメーターに追加される追加のバイトオフセット。

val: IntPtr

書き込む値。

属性: 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

注釈

このメソッドは、32 ビットシステムでは 32 ビット整数、64 ビットシステムでは 64 ビット整数を書き込みます。

アライメントされていないメモリ位置への書き込みはサポートされています。

こちらもご覧ください

適用対象

.NET 9 およびその他のバージョン

製品	バージョン
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

WriteIntPtr(Object, Int32, IntPtr)

ソース:: Marshal.cs

ソース:: Marshal.cs

ソース:: Marshal.cs

注意事項

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

アンマネージメモリにプロセッサネイティブサイズの整数を書き込みます。

public:
 static void WriteIntPtr(System::Object ^ ptr, int ofs, IntPtr val);

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

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

public static void WriteIntPtr(object ptr, int ofs, IntPtr val);

[System.Security.SecurityCritical]
public static void WriteIntPtr(object ptr, int ofs, IntPtr val);

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

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

static member WriteIntPtr : obj * int * nativeint -> unit

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

Public Shared Sub WriteIntPtr (ptr As Object, ofs As Integer, val As IntPtr)

パラメーター

ptr: Object

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

ofs: Int32

書き込みの前に ptr パラメーターに追加される追加のバイトオフセット。

val: IntPtr

書き込む値。

属性: ObsoleteAttribute SecurityCriticalAttribute

例外

AccessViolationException

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

ArgumentException

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

注釈

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

アライメントされていないメモリ位置への書き込みはサポートされています。

こちらもご覧ください

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

適用対象

.NET 9 およびその他のバージョン

製品	バージョン (廃止)
.NET	(Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9)
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 (4.7 (package-provided), 4.7.1 (package-provided), 4.7.2 (package-provided), 4.8 (package-provided))
.NET Standard	1.1, 2.0 (1.2, 1.3, 1.4, 1.5, 1.6, 2.1)
UWP	(10.0)

次の方法で共有

Marshal.WriteIntPtr メソッド

定義

オーバーロード

WriteIntPtr(IntPtr, IntPtr)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

WriteIntPtr(IntPtr, Int32, IntPtr)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

WriteIntPtr(Object, Int32, IntPtr)

パラメーター

例外

注釈

こちらもご覧ください

適用対象

その他のリソース