Marshal.AllocHGlobal Metoda

Definicja

Przestrzeń nazw:

System.Runtime.InteropServices

Zestaw:

System.Runtime.InteropServices.dll

Przydziela pamięć z niezarządzanej pamięci procesu.

Przeciążenia

AllocHGlobal(Int32)	Przydziela pamięć z niezarządzanej pamięci procesu przy użyciu określonej liczby bajtów.
AllocHGlobal(IntPtr)	Przydziela pamięć z niezarządzanej pamięci procesu przy użyciu wskaźnika do określonej liczby bajtów.

AllocHGlobal(Int32)

Źródło:

Marshal.cs

Przydziela pamięć z niezarządzanej pamięci procesu przy użyciu określonej liczby bajtów.

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

Parametry

cb

Int32

Wymagana liczba bajtów w pamięci.

Zwraca

IntPtr

nativeint

Wskaźnik do nowo przydzielonej pamięci. Ta pamięć musi zostać zwolniona przy użyciu FreeHGlobal(IntPtr) metody .

Wyjątki

OutOfMemoryException

Za mało pamięci, aby spełnić żądanie.

Przykłady

W poniższym przykładzie pokazano wywołanie AllocHGlobal metody . Ten przykład kodu jest częścią większego przykładu podanego Marshal dla klasy.

// 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)

Uwagi

AllocHGlobal jest jedną z dwóch metod alokacji pamięci w Marshal klasie. (Marshal.AllocCoTaskMem jest drugą). Ta metoda uwidacznia funkcję Win32 LocalAlloc z Kernel32.dll.

W AllocHGlobal przypadku wywołań LocalAllocprogram przekazuje flagę LMEM_FIXED , co powoduje zablokowanie przydzielonej pamięci. Ponadto przydzielona pamięć nie jest wypełniona zero.

Zobacz też

• AllocCoTaskMem(Int32)
• FreeHGlobal(IntPtr)

AllocHGlobal(IntPtr)

Źródło:

Marshal.Unix.cs

Przydziela pamięć z niezarządzanej pamięci procesu przy użyciu wskaźnika do określonej liczby bajtów.

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

Parametry

cb

IntPtr

nativeint

Wymagana liczba bajtów w pamięci.

Zwraca

IntPtr

nativeint

Wskaźnik do nowo przydzielonej pamięci. Ta pamięć musi zostać zwolniona przy użyciu FreeHGlobal(IntPtr) metody .

Wyjątki

OutOfMemoryException

Za mało pamięci, aby spełnić żądanie.

Uwagi

AllocHGlobal jest jedną z dwóch metod alokacji pamięci w Marshal klasie. (Marshal.AllocCoTaskMem jest drugą). Ta metoda uwidacznia funkcję Win32 LocalAlloc z Kernel32.dll.

W AllocHGlobal przypadku wywołań LocalAllocprogram przekazuje flagę LMEM_FIXED , co powoduje zablokowanie przydzielonej pamięci. Ponadto przydzielona pamięć nie jest wypełniona zero.

Na przykład kod zobacz Marshal i AllocHGlobal.

Zobacz też

• AllocCoTaskMem(Int32)
• FreeHGlobal(IntPtr)