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 da memória não gerenciada do processo usando o número especificado de bytes.
AllocHGlobal(IntPtr)	Aloca memória da memória não gerenciada do processo usando o ponteiro para o número especificado de bytes.

AllocHGlobal(Int32)

Origem:

Marshal.cs

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

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 método AllocHGlobal. Este exemplo de código faz parte de um exemplo maior fornecido para a classe Marshal.

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

Importante

Esse alocador de memória nativa é uma API herdada que deve ser usada exclusivamente quando solicitada por APIs específicas do Win32 na plataforma Windows. Ao direcionar o .NET 6 ou posterior, use a classe NativeMemory em todas as plataformas para alocar memória nativa. Ao direcionar o .NET 6 ou anterior, use AllocCoTaskMem em todas as plataformas para alocar memória nativa.

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

Quando AllocHGlobal chama LocalAlloc, ele passa um sinalizador LMEM_FIXED, 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 da memória não gerenciada do processo usando o ponteiro para o número especificado de bytes.

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

Importante

Esse alocador de memória nativa é uma API herdada que deve ser usada exclusivamente quando solicitada por APIs específicas do Win32 na plataforma Windows. Ao direcionar o .NET 6 ou posterior, use a classe NativeMemory em todas as plataformas para alocar memória nativa. Ao direcionar o .NET 6 ou anterior, use AllocCoTaskMem em todas as plataformas para alocar memória nativa.

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

Quando AllocHGlobal chama LocalAlloc, ele passa um sinalizador LMEM_FIXED, 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)