Marshal.AllocHGlobal Método

Definição

Namespace:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

Aloca memória da memória não gerenciada do processo.

Sobrecargas

AllocHGlobal(Int32)	Aloca memória de memória não gerenciada do processo usando o número de bytes especificado.
AllocHGlobal(IntPtr)	Aloca memória de memória não gerenciada do processo usando o ponteiro para o número de bytes especificado.

AllocHGlobal(Int32)

Origem:

Marshal.cs

Aloca memória de memória não gerenciada do processo usando o número de bytes especificado.

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

Parâmetros

cb

Int32

O número necessário de bytes na memória.

Retornos

IntPtr

nativeint

Um ponteiro para a memória recém-alocada. Essa memória deve ser liberada usando o método FreeHGlobal(IntPtr).

Exceções

OutOfMemoryException

Não há memória suficiente para atender à solicitação.

Exemplos

O exemplo a seguir demonstra a chamada do AllocHGlobal método . Este exemplo de código faz parte de um exemplo maior fornecido para a Marshal classe .

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

Comentários

AllocHGlobal é um dos dois métodos de alocação de memória na Marshal classe . (Marshal.AllocCoTaskMem é o outro.) Esse método expõe a função LocalAlloc do Win32 de Kernel32.dll.

Quando AllocHGlobal chama LocalAlloc, ele passa um LMEM_FIXED sinalizador, o que faz com que a memória alocada seja bloqueada no local. Além disso, a memória alocada não é preenchida com zero.

Confira também

• AllocCoTaskMem(Int32)
• FreeHGlobal(IntPtr)

AllocHGlobal(IntPtr)

Origem:

Marshal.Unix.cs

Aloca memória de memória não gerenciada do processo usando o ponteiro para o número de bytes especificado.

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

Parâmetros

cb

IntPtr

nativeint

O número necessário de bytes na memória.

Retornos

IntPtr

nativeint

Um ponteiro para a memória recém-alocada. Essa memória deve ser liberada usando o método FreeHGlobal(IntPtr).

Exceções

OutOfMemoryException

Não há memória suficiente para atender à solicitação.

Comentários

AllocHGlobal é um dos dois métodos de alocação de memória na Marshal classe . (Marshal.AllocCoTaskMem é o outro.) Esse método expõe a função LocalAlloc do Win32 de Kernel32.dll.

Quando AllocHGlobal chama LocalAlloc, ele passa um LMEM_FIXED sinalizador, o que faz com que a memória alocada seja bloqueada no local. Além disso, a memória alocada não é preenchida com zero.

Por exemplo, código, consulte Marshal e AllocHGlobal.

Confira também

• AllocCoTaskMem(Int32)
• FreeHGlobal(IntPtr)