NativeMemory.AlignedAlloc(UIntPtr, UIntPtr) Méthode

Définition

Espace de noms:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

Source:

NativeMemory.Unix.cs

Important

Cette API n’est pas conforme CLS.

Alloue un bloc aligné de mémoire de la taille et de l’alignement spécifiés, en octets.

public:
 static void* AlignedAlloc(UIntPtr byteCount, UIntPtr alignment);

[System.CLSCompliant(false)]
public static void* AlignedAlloc(UIntPtr byteCount, UIntPtr alignment);

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

Paramètres

byteCount

UIntPtr

nuint

unativeint

Taille, en octets, du bloc à allouer.

alignment

UIntPtr

nuint

unativeint

Alignement, en octets, du bloc à allouer. Il doit s’agir d’une puissance de 2.

Retours

Void*

Pointeur vers le bloc aligné alloué de mémoire.

Attributs

CLSCompliantAttribute

Exceptions

ArgumentException

alignment n’est pas un pouvoir de deux.

OutOfMemoryException

Échec de l’allocation byteCount de mémoire alignment .

Remarques

Cette méthode permet byteCount d’être 0 et retourne un pointeur valide qui ne doit pas être déréférencement et qui doit être transmis gratuitement pour éviter les fuites de mémoire.

Cette méthode est un wrapper mince sur l’API C aligned_alloc ou une API d’allocation alignée dépendante de la plateforme, comme _aligned_malloc sur Win32.

Cette méthode n’est pas compatible avec Free(Void*) ou Realloc(Void*, UIntPtr). Au lieu de cela, appelez AlignedFree(Void*) ou AlignedRealloc(Void*, UIntPtr, UIntPtr).