Marshal.ReadIntPtr Yöntem

Tanım

Ad Alanı:

System.Runtime.InteropServices

Bütünleştirilmiş Kod:

System.Runtime.InteropServices.dll

Yönetilmeyen bellekten işlemcinin yerel boyutlu tamsayısını okur. Hizalanmamış bellek konumlarından okuma desteklenir.

Aşırı Yüklemeler

ReadIntPtr(IntPtr, Int32)	Yönetilmeyen bellekten belirli bir uzaklıkta işlemci yerel boyutlu bir tamsayı okur.
ReadIntPtr(Object, Int32)	Geçersiz. Yönetilmeyen bellekten işlemcinin yerel boyutlu tamsayısını okur.
ReadIntPtr(IntPtr)	Yönetilmeyen bellekten yerel boyutlu işlemci tamsayısını okur.

ReadIntPtr(IntPtr, Int32)

Kaynak:

Marshal.cs

Yönetilmeyen bellekten belirli bir uzaklıkta işlemci yerel boyutlu bir tamsayı okur.

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

Parametreler

ptr

IntPtr

Yönetilmeyen bellekte okuması gereken temel adres.

ofs

Int32

Okumadan önce parametresine ptr eklenen ek bir bayt uzaklığı.

Döndürülenler

IntPtr

Verilen uzaklıkta yönetilmeyen bellekten okunan tamsayı.

Özel durumlar

AccessViolationException

Temel adres (ptr) artı uzaklık bayt (ofs) null veya geçersiz bir adres üretir.

Örnekler

Aşağıdaki örnekte ve WriteIntPtr yöntemlerini kullanarak ReadIntPtr yönetilmeyen bir diziyi okuma ve yazma işlemleri gösterilmektedir.

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();
}

Açıklamalar

ReadIntPtr yönetilmeyen bir C stili IntPtr diziyle doğrudan etkileşime olanak sağlayarak, tüm yönetilmeyen diziyi (kullanarak Marshal.Copy) öğe değerlerini okumadan önce ayrı bir yönetilen diziye kopyalamanın masrafını ortadan kaldırır.

Hizalanmamış bellek konumlarından okuma desteklenir.

Ayrıca bkz.

• Copy(Int32[], Int32, IntPtr, Int32)
• ReadByte(Object, Int32)

ReadIntPtr(Object, Int32)

Kaynak:

Marshal.cs

Dikkat

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

Yönetilmeyen bellekten işlemcinin yerel boyutlu tamsayısını okur.

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

Parametreler

ptr

Object

Kaynak nesnenin yönetilmeyen belleğindeki temel adres.

ofs

Int32

Okumadan önce parametresine ptr eklenen ek bir bayt uzaklığı.

Döndürülenler

IntPtr

Verilen uzaklıkta yönetilmeyen bellekten okunan tamsayı.

Öznitelikler

ObsoleteAttribute

Özel durumlar

AccessViolationException

Temel adres (ptr) artı uzaklık bayt (ofs) null veya geçersiz bir adres üretir.

ArgumentException

ptr bir ArrayWithOffset nesnedir. Bu yöntem parametreleri kabul ArrayWithOffset etmez.

Açıklamalar

ReadIntPtr yönetilmeyen bir C stili IntPtr diziyle doğrudan etkileşime olanak sağlayarak, tüm yönetilmeyen diziyi (kullanarak Marshal.Copy) öğe değerlerini okumadan önce ayrı bir yönetilen diziye kopyalamanın masrafını ortadan kaldırır.

Hizalanmamış bellek konumlarından okuma desteklenir.

Ayrıca bkz.

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

ReadIntPtr(IntPtr)

Kaynak:

Marshal.cs

Yönetilmeyen bellekten yerel boyutlu işlemci tamsayısını okur.

public static IntPtr ReadIntPtr (IntPtr ptr);

Parametreler

ptr

IntPtr

Yönetilmeyen bellekte okunacak adres.

Döndürülenler

IntPtr

Yönetilmeyen bellekten okunan tamsayı. 32 bit makinelerde 32 bit tamsayı, 64 bit makinelerde ise 64 bit tamsayı döndürülür.

Özel durumlar

AccessViolationException

ptr tanınan bir biçim değildir.

-veya-

ptr, null değeridir.

-veya-

ptr geçersizdir.

Örnekler

Aşağıdaki örnekte ve WriteIntPtr yöntemlerini kullanarak ReadIntPtr yönetilmeyen bir diziyi okuma ve yazma işlemleri gösterilmektedir.

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();
}

Açıklamalar

ReadIntPtr 0 zımni uzaklığı vardır. Bu yöntem yönetilmeyen bir C stili IntPtr diziyle doğrudan etkileşime olanak sağlayarak, tüm yönetilmeyen diziyi (kullanarak Marshal.Copy) öğe değerlerini okumadan önce ayrı bir yönetilen diziye kopyalamanın masrafını ortadan kaldırır.

Hizalanmamış bellek konumlarından okuma desteklenir.

Ayrıca bkz.

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