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