Marshal.WriteIntPtr 메서드

  • 참조

정의

네임스페이스:
System.Runtime.InteropServices
어셈블리:
System.Runtime.InteropServices.dll
어셈블리:
mscorlib.dll
어셈블리:
netstandard.dll

관리되지 않는 메모리에 프로세서의 기본 크기로 지정된 정수 값을 씁니다. 32비트 시스템에는 32비트 정수를 쓰고 64비트 시스템에는 64비트 정수를 씁니다. 정렬되지 않은 메모리 위치에 쓸 수 있습니다.

오버로드

WriteIntPtr(IntPtr, IntPtr)

관리되지 않는 메모리에 프로세서의 기본 크기로 지정된 정수 값을 씁니다.
WriteIntPtr(IntPtr, Int32, IntPtr)

관리되지 않는 메모리의 지정된 오프셋 위치에 프로세서의 기본 크기로 지정된 정수 값을 씁니다.
WriteIntPtr(Object, Int32, IntPtr)
사용되지 않음.

관리되지 않는 메모리에 프로세서의 기본 크기로 지정된 정수 값을 씁니다.

WriteIntPtr(IntPtr, IntPtr)

Source:
Marshal.cs
Source:
Marshal.cs
Source:
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

nativeint

관리되지 않는 메모리에서 값을 쓸 주소입니다.

val
IntPtr

nativeint

작성할 값입니다.

특성
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)을 별도의 관리형 배열로 복사하는 비용이 없습니다.

정렬되지 않은 메모리 위치에 쓸 수 있습니다.

추가 정보

적용 대상

WriteIntPtr(IntPtr, Int32, IntPtr)

Source:
Marshal.cs
Source:
Marshal.cs
Source:
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

nativeint

관리되지 않는 메모리에서 값을 쓸 기본 주소입니다.

ofs
Int32

쓰기 전에 ptr 매개 변수에 추가되는 추가 바이트 오프셋입니다.

val
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

설명

이 메서드는 32비트 시스템에서 32비트 정수, 64비트 시스템의 64비트 정수로 씁니다.

WriteIntPtr 를 사용하면 관리되지 않는 C 스타일 IntPtr 배열과 직접 상호 작용할 수 있으므로 요소 값을 설정하기 전에 관리되지 않는 전체 배열(사용 Marshal.Copy)을 별도의 관리형 배열로 복사하는 비용이 없습니다.

정렬되지 않은 메모리 위치에 쓸 수 있습니다.

추가 정보

적용 대상

WriteIntPtr(Object, Int32, IntPtr)

Source:
Marshal.cs
Source:
Marshal.cs
Source:
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

nativeint

작성할 값입니다.

특성
ObsoleteAttribute SecurityCriticalAttribute

예외

AccessViolationException

기준 주소(ptr)에 오프셋 바이트(ofs)를 더하면 null 또는 잘못된 주소가 생성되는 경우

ArgumentException

ptr이 ArrayWithOffset 개체인 경우. 이 메서드에는 ArrayWithOffset 매개 변수를 사용할 수 없습니다.

설명

WriteIntPtr 를 사용하면 관리되지 않는 C 스타일 바이트 배열과 직접 상호 작용할 수 있으므로 요소 값을 설정하기 전에 관리되지 않는 전체 배열(사용 Marshal.Copy)을 별도의 관리형 배열로 복사하는 비용이 제거됩니다.

정렬되지 않은 메모리 위치에 쓸 수 있습니다.

추가 정보

적용 대상