Marshal.AllocHGlobal Yöntem

Tanım

Ad Alanı:

System.Runtime.InteropServices

Bütünleştirilmiş Kod:

System.Runtime.InteropServices.dll

İşlemin yönetilmeyen belleğinden bellek ayırır.

Aşırı Yüklemeler

AllocHGlobal(Int32)	Belirtilen bayt sayısını kullanarak işlemin yönetilmeyen belleğinden bellek ayırır.
AllocHGlobal(IntPtr)	belirtilen bayt sayısı işaretçisini kullanarak işlemin yönetilmeyen belleğinden bellek ayırır.

AllocHGlobal(Int32)

Kaynak:

Marshal.cs

Belirtilen bayt sayısını kullanarak işlemin yönetilmeyen belleğinden bellek ayırır.

public:
 static IntPtr AllocHGlobal(int cb);

public static IntPtr AllocHGlobal (int cb);

static member AllocHGlobal : int -> nativeint

Public Shared Function AllocHGlobal (cb As Integer) As IntPtr

Parametreler

cb

Int32

Bellekte gerekli bayt sayısı.

Döndürülenler

IntPtr

nativeint

Yeni ayrılan belleğin işaretçisi. Bu bellek FreeHGlobal(IntPtr) yöntemi kullanılarak serbest bırakılmalıdır.

Özel durumlar

OutOfMemoryException

İsteği karşılamak için yeterli bellek yok.

Örnekler

Aşağıdaki örnekte AllocHGlobal yönteminin çağrılması gösterilmektedir. Bu kod örneği, Marshal sınıfı için sağlanan daha büyük bir örneğin parçasıdır.

// Demonstrate how to call GlobalAlloc and 
// GlobalFree using the Marshal class.
IntPtr hglobal = Marshal::AllocHGlobal(100);
Marshal::FreeHGlobal(hglobal);

// Demonstrate how to call GlobalAlloc and
// GlobalFree using the Marshal class.
IntPtr hglobal = Marshal.AllocHGlobal(100);
Marshal.FreeHGlobal(hglobal);

' Demonstrate how to call GlobalAlloc and 
' GlobalFree using the Marshal class.
Dim hglobal As IntPtr = Marshal.AllocHGlobal(100)
Marshal.FreeHGlobal(hglobal)

Açıklamalar

Önemli

Bu yerel bellek ayırıcısı, Yalnızca Windows platformundaki belirli Win32 API'leri tarafından çağrıldığında kullanılması gereken eski bir API'dir. .NET 6 veya üzerini hedeflerken yerel bellek ayırmak için tüm platformlardaki NativeMemory sınıfını kullanın. .NET 6 veya önceki sürümleri hedeflerken yerel bellek ayırmak için tüm platformlarda AllocCoTaskMem kullanın.

AllocHGlobal, Marshal sınıfındaki iki bellek ayırma yönteminden biridir. (Marshal.AllocCoTaskMem diğeridir.) Bu yöntem, Kernel32.dll'den Win32 LocalAlloc işlevini kullanıma sunar.

AllocHGlobal LocalAllocçağırdığında, ayrılan belleğin yerinde kilitlenmesine neden olan bir LMEM_FIXED bayrağı geçirir. Ayrıca, ayrılan bellek sıfır dolu değil.

Ayrıca bkz.

• AllocCoTaskMem(Int32)
• FreeHGlobal(IntPtr)

AllocHGlobal(IntPtr)

Kaynak:

Marshal.Unix.cs

belirtilen bayt sayısı işaretçisini kullanarak işlemin yönetilmeyen belleğinden bellek ayırır.

public:
 static IntPtr AllocHGlobal(IntPtr cb);

public static IntPtr AllocHGlobal (IntPtr cb);

static member AllocHGlobal : nativeint -> nativeint

Public Shared Function AllocHGlobal (cb As IntPtr) As IntPtr

Parametreler

cb

IntPtr

nativeint

Bellekte gerekli bayt sayısı.

Döndürülenler

IntPtr

nativeint

Yeni ayrılan belleğin işaretçisi. Bu bellek FreeHGlobal(IntPtr) yöntemi kullanılarak serbest bırakılmalıdır.

Özel durumlar

OutOfMemoryException

İsteği karşılamak için yeterli bellek yok.

Açıklamalar

Önemli

Bu yerel bellek ayırıcısı, Yalnızca Windows platformundaki belirli Win32 API'leri tarafından çağrıldığında kullanılması gereken eski bir API'dir. .NET 6 veya üzerini hedeflerken yerel bellek ayırmak için tüm platformlardaki NativeMemory sınıfını kullanın. .NET 6 veya önceki sürümleri hedeflerken yerel bellek ayırmak için tüm platformlarda AllocCoTaskMem kullanın.

AllocHGlobal, Marshal sınıfındaki iki bellek ayırma yönteminden biridir. (Marshal.AllocCoTaskMem diğeridir.) Bu yöntem, Kernel32.dll'den Win32 LocalAlloc işlevini kullanıma sunar.

AllocHGlobal LocalAllocçağırdığında, ayrılan belleğin yerinde kilitlenmesine neden olan bir LMEM_FIXED bayrağı geçirir. Ayrıca, ayrılan bellek sıfır dolu değil.

Örneğin kod, bkz. Marshal ve AllocHGlobal.

Ayrıca bkz.

• AllocCoTaskMem(Int32)
• FreeHGlobal(IntPtr)