_aligned_realloc
Изменяет размер блока памяти, выделенного с помощью _aligned_malloc или _aligned_offset_malloc.
void * _aligned_realloc(
void *memblock,
size_t size,
size_t alignment
);
Параметры
[входящий] memblock
Текущий указатель на блок памяти.[входящий] size
Размер запрошенного выделения памяти.[входящий] alignment
Значение выравнивания, которое должно быть целочисленной степенью двойки.
Возвращаемое значение
_aligned_realloc возвращает void указатель перераспределенный (и, возможно, перемещенный) блок памяти. Возвращаемое значение равно NULL, если размер равен нулю и аргумент буфера не равен NULL, или если доступной памяти недостаточно, чтобы развернуть блок заданного размера. В первом случае исходный блок освобождается. Во втором случае исходный блок не изменяется. Возвращаемое значение указывает на дисковое пространство, которое гарантированно выравнено подходящим для хранения любого типа объекта образом. Чтобы получить указатель на тип, отличный от void, используйте приведение типа для возвращаемого значения.
Перераспределение памяти и изменение выравнивания блока является ошибкой.
Заметки
_aligned_realloc основан на malloc. Дополнительные сведения об использовании _aligned_offset_malloc см. в разделе malloc.
Эта функция устанавливает errno в значение ENOMEM, выделение памяти завершилось неудачно, или если запрошенный размер был больше _HEAP_MAXREQ. Дополнительные сведения о errno см. в разделе errno, _doserrno, _sys_errlist, and _sys_nerr. Кроме того, _aligned_realloc проверяет свои параметры. Если alignment не является степенью 2, эта функция вызывает обработчик недопустимого параметра, как описано в разделе Проверка параметров. Если продолжение выполнения разрешено, эта функция возвращает NULL и устанавливает errno в значение EINVAL.
Требования
Подпрограмма |
Обязательный заголовок |
|---|---|
_aligned_realloc |
<malloc.h> |
Пример
Дополнительные сведения см. в разделе _aligned_malloc