NativeMemory.AllocZeroed 方法

定義

命名空間:

System.Runtime.InteropServices

組件:

System.Runtime.InteropServices.dll

多載

AllocZeroed(UIntPtr)	以位元組為單位，配置和零指定大小的記憶體區塊。
AllocZeroed(UIntPtr, UIntPtr)	在元素中配置和零指定大小的記憶體區塊。

AllocZeroed(UIntPtr)

來源:

NativeMemory.cs

重要

此 API 不符合 CLS 規範。

以位元組為單位，配置和零指定大小的記憶體區塊。

public:
 static void* AllocZeroed(UIntPtr byteCount);

[System.CLSCompliant(false)]
public static void* AllocZeroed (UIntPtr byteCount);

[<System.CLSCompliant(false)>]
static member AllocZeroed : unativeint -> nativeptr<unit>

參數

byteCount

UIntPtr

nuint

unativeint

要配置的區塊大小，以位元組為單位。

傳回

Void*

已配置和零記憶體區塊的指標。

屬性

CLSCompliantAttribute

例外狀況

OutOfMemoryException

配置 byteCount 記憶體失敗。

備註

這個方法允許 byteCount 和會 0 傳回不應該被取值的有效指標，而且應該傳遞以釋放以避免記憶體流失。

此方法是透過 C calloc API 的精簡包裝函式。

AllocZeroed(UIntPtr, UIntPtr)

來源:

NativeMemory.Unix.cs

重要

此 API 不符合 CLS 規範。

在元素中配置和零指定大小的記憶體區塊。

public:
 static void* AllocZeroed(UIntPtr elementCount, UIntPtr elementSize);

[System.CLSCompliant(false)]
public static void* AllocZeroed (UIntPtr elementCount, UIntPtr elementSize);

[<System.CLSCompliant(false)>]
static member AllocZeroed : unativeint * unativeint -> nativeptr<unit>

參數

elementCount

UIntPtr

nuint

unativeint

要配置的區塊計數，以元素為單位。

elementSize

UIntPtr

nuint

unativeint

配置中每個元素的大小，以位元組為單位。

傳回

Void*

已配置和零記憶體區塊的指標。

屬性

CLSCompliantAttribute

例外狀況

OutOfMemoryException

配置 elementCount * elementSize 記憶體的位元組失敗。

備註

這個方法允許 elementCount 與 elementSize 成為 0。 它會傳回不應該被取值的有效指標，而且應該傳遞以釋放以避免記憶體流失。

此方法是透過 C calloc API 的精簡包裝函式。