Compartilhar via


NativeMemory.AlignedAlloc(UIntPtr, UIntPtr) Método

Definição

Importante

Esta API não está em conformidade com CLS.

Aloca um bloco alinhado de memória do tamanho e alinhamento especificados, em bytes.

public:
 static void* AlignedAlloc(UIntPtr byteCount, UIntPtr alignment);
[System.CLSCompliant(false)]
public static void* AlignedAlloc (nuint byteCount, nuint alignment);
[System.CLSCompliant(false)]
public static void* AlignedAlloc (UIntPtr byteCount, UIntPtr alignment);
[<System.CLSCompliant(false)>]
static member AlignedAlloc : unativeint * unativeint -> nativeptr<unit>

Parâmetros

byteCount
UIntPtr

nuint

unativeint

O tamanho, em bytes, do bloco a ser alocado.

alignment
UIntPtr

nuint

unativeint

O alinhamento, em bytes, do bloco a ser alocado. Isso deve ser uma potência de 2.

Retornos

Void*

Um ponteiro para o bloco de memória alinhado alocado.

Atributos

Exceções

alignment não é um poder de dois.

Falha na alocação byteCount de memória alignment .

Comentários

Esse método permite ser 0 e retornará um ponteiro válido que não deve ser desreferenciado byteCount e que deve ser passado para livre para evitar vazamentos de memória.

Esse método é um wrapper fino sobre a API C aligned_alloc ou uma API de alocação alinhada dependente da plataforma, como _aligned_malloc no Win32.

Esse método não é compatível com Free(Void*) ou Realloc(Void*, UIntPtr). Em vez disso, chame AlignedFree(Void*) ou AlignedRealloc(Void*, UIntPtr, UIntPtr).

Aplica-se a