Marshal.AllocHGlobal メソッド

定義

名前空間:

System.Runtime.InteropServices

アセンブリ:

System.Runtime.InteropServices.dll

プロセスのアンマネージ メモリからメモリを割り当てます。

オーバーロード

AllocHGlobal(Int32)	指定したバイト数を使用して、プロセスのアンマネージ メモリからメモリを割り当てます。
AllocHGlobal(IntPtr)	指定したバイト数へのポインターを使用して、プロセスのアンマネージ メモリからメモリを割り当てます。

AllocHGlobal(Int32)

ソース:

Marshal.cs

指定したバイト数を使用して、プロセスのアンマネージ メモリからメモリを割り当てます。

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

パラメーター

cb

Int32

メモリ内で必要なバイト数。

戻り値

IntPtr

nativeint

新しく割り当てられたメモリへのポインター。 このメモリは、FreeHGlobal(IntPtr) メソッドを使用して解放する必要があります。

例外

OutOfMemoryException

メモリが不足しているため要求を満たせません。

例

次の例では、AllocHGlobal メソッドを呼び出す方法を示しています。 このコード例は、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)

注釈

AllocHGlobal は、 クラス内の 2 つのメモリ割り当てメソッドのいずれか Marshal です。 (Marshal.AllocCoTaskMem はもう一方です)。このメソッドは、Kernel32.dll から Win32 LocalAlloc 関数を公開します。

を呼び出LocalAllocすとAllocHGlobal、フラグがLMEM_FIXED渡され、割り当てられたメモリが所定の位置にロックされます。 また、割り当てられたメモリは 0 で埋め込まれません。

こちらもご覧ください

• AllocCoTaskMem(Int32)
• FreeHGlobal(IntPtr)

AllocHGlobal(IntPtr)

ソース:

Marshal.Unix.cs

指定したバイト数へのポインターを使用して、プロセスのアンマネージ メモリからメモリを割り当てます。

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

パラメーター

cb

IntPtr

nativeint

メモリ内で必要なバイト数。

戻り値

IntPtr

nativeint

新しく割り当てられたメモリへのポインター。 このメモリは、FreeHGlobal(IntPtr) メソッドを使用して解放する必要があります。

例外

OutOfMemoryException

メモリが不足しているため要求を満たせません。

注釈

AllocHGlobal は、 クラス内の 2 つのメモリ割り当てメソッドのいずれか Marshal です。 (Marshal.AllocCoTaskMem はもう一方です)。このメソッドは、Kernel32.dll から Win32 LocalAlloc 関数を公開します。

を呼び出LocalAllocすとAllocHGlobal、フラグがLMEM_FIXED渡され、割り当てられたメモリが所定の位置にロックされます。 また、割り当てられたメモリは 0 で埋め込まれません。

コード例については、 と AllocHGlobalを参照してくださいMarshal。

こちらもご覧ください

• AllocCoTaskMem(Int32)
• FreeHGlobal(IntPtr)