NativeMemory.AlignedAlloc(UIntPtr, UIntPtr) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Ważne
Ten interfejs API nie jest zgodny ze specyfikacją CLS.
Przydziela wyrównany blok pamięci o określonym rozmiarze i wyrównaniu w bajtach.
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>
Parametry
- byteCount
-
UIntPtr
nuint
unativeint
Rozmiar bloku do przydzielenia w bajtach.
- alignment
-
UIntPtr
nuint
unativeint
Wyrównanie w bajtach bloku do przydzielenia. Musi to być potęga .2
Zwraca
Wskaźnik do przydzielonego wyrównanego bloku pamięci.
- Atrybuty
Wyjątki
alignment
nie jest potęgą dwóch.
Przydzielanie byteCount
pamięci z alignment
niepowodzeniem.
Uwagi
Ta metoda pozwala byteCount
na zwrócenie 0
prawidłowego wskaźnika, który nie powinien być wyłuszany i który należy przekazać, aby uniknąć przecieków pamięci.
Ta metoda jest cienką otoką interfejsu API języka C aligned_alloc
lub zależnym od platformy interfejsem API alokacji, takim jak _aligned_malloc
win32.
Ta metoda nie jest zgodna z programem Free(Void*) lub Realloc(Void*, UIntPtr). Zamiast tego wywołaj metodę AlignedFree(Void*) lub AlignedRealloc(Void*, UIntPtr, UIntPtr).