_aligned_offset_malloc_dbg
Размещение памяти на указанной границе выравнивания (только в отладочной версии).
Синтаксис
void * _aligned_offset_malloc_dbg(
size_t size,
size_t alignment,
size_t offset,
const char *filename,
int linenumber
);
Параметры
size
Размер запрошенного выделения памяти.
alignment
Значение выравнивания, которое должно быть целой степенью числа 2.
offset
Смещение в выделение памяти для принудительного выполнения выравнивания.
filename
Указатель на имя исходного файла, который запросил операцию выделения, или NULL.
linenumber
Номер строки в исходном файле, в которой была запрошена операция выделения, или NULL.
Возвращаемое значение
Указатель на выделенный блок памяти или значение NULL в случае сбоя операции.
Замечания
_aligned_offset_malloc_dbg — это отладочная версия _aligned_offset_malloc функции. Если _DEBUG не определено, каждый вызов _aligned_offset_malloc_dbg уменьшается до вызова _aligned_offset_malloc. И _aligned_offset_malloc, и _aligned_offset_malloc_dbg выполняют выделение блока памяти в основной куче, однако _aligned_offset_malloc_dbg включает различные возможности отладки: буферы на обеих сторонах пользовательской части блока для тестирования утечек и сведения о filename/linenumber для определения источника запросов на выделение. Отслеживание определенных типов выделения с параметром типа блока не является поддерживаемой функцией отладки для выровненных выделений. Выровненные выделения будут отображаться как _NORMAL_BLOCK тип блока.
_aligned_offset_malloc_dbg выделяет блок памяти, добавив немного больше пространства, чем запрошено size. Дополнительное пространство используется диспетчером кучи отладки для связывания блоков памяти отладки и предоставления приложению сведений о заголовках отладки и перезаписи буферов. При выделении блока пользовательская часть блока заполняется значением 0xCD, а каждый из буферов перезаписи заполняется 0xFD.
_aligned_offset_malloc_dbg можно использовать в ситуациях, когда необходимо выравнивание вложенного элемента, например, если требуется выравнивание вложенного класса.
_aligned_offset_malloc_dbg основан на malloc; дополнительные сведения см. в разделе malloc.
Эта функция задает для errno значение ENOMEM в случае сбоя выделения памяти или если запрошенный размер был больше _HEAP_MAXREQ. Дополнительные сведения о , см. в errnoразделеerrno , _doserrno_sys_errlistи _sys_nerr. Кроме того, _aligned_offset_malloc проверяет свои параметры. Если alignment значение не равно 2, или offset если значение не равно нулю и больше или равно size, эта функция вызывает обработчик недопустимых параметров, как описано в разделе проверки параметров. Если продолжение выполнения разрешено, эта функция возвращает NULL и задает для errno значение EINVAL.
Сведения о выделении, инициализации и управлении блоками памяти в отладочной версии базовой кучи см. в сведениях об отладочной куче CRT.
Сведения о типах блоков выделения и их использовании см. в разделе "Типы блоков" в куче отладки.
Требования
| Маршрут | Обязательный заголовок |
|---|---|
_aligned_offset_malloc_dbg |
<crtdbg.h> |
Дополнительные сведения о совместимости см. в разделе Совместимость.
Библиотеки
Только отладочные версии библиотек времени выполнения языка C.