Marshal.ReadIntPtr Método

Definição

Espaço de Nomes:: System.Runtime.InteropServices

Assemblagens:: mscorlib.dll, System.Runtime.InteropServices.dll

Assemblagem:: mscorlib.dll

Assemblagem:: System.Runtime.InteropServices.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Lê um inteiro de tamanho nativo de processador a partir de memória não gerida. É suportada a leitura de locais de memória desalinhados.

Sobrecargas

Name	Description
ReadIntPtr(IntPtr, Int32)	Lê um inteiro de tamanho nativo de processador a um dado deslocamento a partir da memória não gerida.
ReadIntPtr(Object, Int32)	Obsoleto. Lê um inteiro de tamanho nativo de processador a partir de memória não gerida.
ReadIntPtr(IntPtr)	Lê um inteiro de tamanho nativo de processador a partir de memória não gerida.

ReadIntPtr(IntPtr, Int32)

Lê um inteiro de tamanho nativo de processador a um dado deslocamento a partir da memória não gerida.

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

Parâmetros

ptr: IntPtr
nativeint

O endereço base na memória não gerida de onde se pode ler.

ofs: Int32

Um deslocamento adicional de byte, que é adicionado ao ptr parâmetro antes da leitura.

Devoluções

IntPtr

nativeint

O inteiro lido a partir da memória não gerida no deslocamento dado.

Atributos: SecurityCriticalAttribute

Exceções

AccessViolationException

O endereço base (ptr) mais o byte offset (ofs) produz um endereço nulo ou inválido.

Exemplos

O exemplo seguinte demonstra como ler e escrever num array não gerido usando os ReadIntPtr métodos e.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

Observações

ReadIntPtr permite a interação direta com um array não gerido ao estilo IntPtr C, eliminando o custo de copiar um array inteiro não gerido (usando Marshal.Copy) para um array gerido separado antes de ler os seus valores de elementos.

É suportada a leitura de locais de memória desalinhados.

Ver também

Aplica-se a

ReadIntPtr(Object, Int32)

Atenção

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

Lê um inteiro de tamanho nativo de processador a partir de memória não gerida.

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

Parâmetros

ptr: Object

O endereço base na memória não gerida do objeto de origem.

ofs: Int32

Um deslocamento adicional de byte, que é adicionado ao ptr parâmetro antes da leitura.

Devoluções

IntPtr

nativeint

O inteiro lido a partir da memória não gerida no deslocamento dado.

Atributos: ObsoleteAttribute SecurityCriticalAttribute

Exceções

AccessViolationException

O endereço base (ptr) mais o byte offset (ofs) produz um endereço nulo ou inválido.

ArgumentException

ptr é um ArrayWithOffset objeto. Este método não aceita ArrayWithOffset parâmetros.

Observações

É suportada a leitura de locais de memória desalinhados.

Ver também

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

Aplica-se a

ReadIntPtr(IntPtr)

Lê um inteiro de tamanho nativo de processador a partir de memória não gerida.

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

Parâmetros

ptr: IntPtr
nativeint

O endereço na memória não gerida para ler.

Devoluções

IntPtr

nativeint

O inteiro é lido a partir da memória não gerida. Um inteiro de 32 bits é devolvido em máquinas de 32 bits e um inteiro de 64 bits é devolvido em máquinas de 64 bits.

Atributos: SecurityCriticalAttribute

Exceções

AccessViolationException

ptr não é um formato reconhecido.

-ou-

ptr é null.

-ou-

ptr é inválido.

Exemplos

O exemplo seguinte demonstra como ler e escrever num array não gerido usando os ReadIntPtr métodos e.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

Observações

ReadIntPtr tem um deslocamento implícito de 0. Este método permite a interação direta com um array não gerido ao estilo IntPtr C, eliminando o custo de copiar um array não gerido inteiro (usando Marshal.Copy) para um array gerido separado antes de ler os seus valores de elementos.

É suportada a leitura de locais de memória desalinhados.

Ver também

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

Aplica-se a

Comentários

Esta página foi útil?