_aligned_msize

Возвращает размер блока памяти, выделенного в куче.

Синтаксис

size_t _aligned_msize(
   void *memblock,
   size_t alignment,
   size_t offset
);

Параметры

memblock
Указатель на блок памяти.

alignment
Значение выравнивания, которое должно быть целой степенью числа 2.

offset
Смещение в выделение памяти для принудительного выполнения выравнивания.

Возвращаемое значение

Возвращает размер (в байтах) как целое число без знака.

Замечания

Функция _aligned_msize возвращает размер блока памяти, выделенного вызовом _aligned_malloc или _aligned_realloc. Значения alignment и offset должны совпадать со значениями, которые были переданы функции, выделившей блок.

Если приложение связано с отладочной версией библиотек времени выполнения C, _aligned_msize разрешается в _aligned_msize_dbg. Дополнительные сведения о том, как куча управляется во время отладки, см. в разделе "Отладочная куча CRT".

Эта функция проверяет свои параметры. Если memblock имеет значение NULL или alignment не имеет значения 2, _aligned_msize вызывается недопустимый обработчик параметров, как описано в разделе проверки параметров. Если ошибка обработана, функция задает для параметра errno значение EINVAL и возвращает -1.

По умолчанию глобальное состояние этой функции ограничивается приложением. Чтобы изменить это поведение, см . статью "Глобальное состояние" в CRT.

Требования

Маршрут	Обязательный заголовок
_aligned_msize	<malloc.h>

Дополнительные сведения о совместимости см. в разделе Совместимость.

Библиотеки

Все версии библиотек времени выполнения языка C.

См. также

Распределение памяти