NativeMemory.AlignedRealloc(Void*, UIntPtr, UIntPtr) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Внимание
Этот API несовместим с CLS.
Перераспределяет выровненный блок памяти указанного размера и выравнивания в байтах.
public:
static void* AlignedRealloc(void* ptr, UIntPtr byteCount, UIntPtr alignment);
[System.CLSCompliant(false)]
public static void* AlignedRealloc(void* ptr, UIntPtr byteCount, UIntPtr alignment);
[System.CLSCompliant(false)]
public static void* AlignedRealloc(void* ptr, nuint byteCount, nuint alignment);
[<System.CLSCompliant(false)>]
static member AlignedRealloc : nativeptr<unit> * unativeint * unativeint -> nativeptr<unit>
Параметры
- ptr
- Void*
Ранее выделенный блок памяти.
- byteCount
-
UIntPtr
nuint
unativeint
Размер блока в байтах для выделения.
- alignment
-
UIntPtr
nuint
unativeint
Выравнивание в байтах блока для выделения. Это должна быть сила 2.
Возвращаемое значение
Указатель на перераспределенный выровненный блок памяти.
- Атрибуты
Исключения
alignment не сила двух.
Перераспределение byteCount памяти с alignment ошибкой.
Комментарии
Этот метод действует так, как AlignedAlloc(UIntPtr, UIntPtr) будто ptrnull.
Этот метод позволяет byteCount и 0 будет возвращать допустимый указатель, который не следует разыменовывать и который следует передавать бесплатно, чтобы избежать утечки памяти.
Этот метод является зависимым от платформы API перемещений, например _aligned_realloc в Win32.
Этот метод несовместим с Free(Void*) или Realloc(Void*, UIntPtr)не совместим. Вместо этого вызов AlignedFree(Void*) или AlignedRealloc(Void*, UIntPtr, UIntPtr).