_aligned_recalloc_dbg

更改随 _aligned_malloc_aligned_offset_malloc 并初始化内存到 0 的范围内存块 (请只调试版本)。

void * _aligned_recalloc_dbg(
   void * memblock, 
   size_t num,
   size_t size, 
   size_t alignment,
   const char *filename,
   int linenumber
);

参数

  • [in] memblock
    当前内存块指针。

  • [in] num
    元素的数目。

  • [in] size
    大小 (以字节为单位) 每个元素。

  • [in] alignment
    对齐值,则必须是整数幂的 2。

  • [in] filename
    对请求分配操作或 NULL源文件的名称的指针。

  • [in] linenumber
    在分配请求的操作或 NULL的源文件中的行号。

返回值

_aligned_recalloc_dbg 返回无效指针重新分配的 (也可能是移动) 内存块。 返回值是 NULL ,如果大小为零,而缓冲区参数不是 NULL,或者,如果没有展开块足够的可用内存到给定范围。 在第一种情况下,原始的块被释放。 在第二种情况下,原始的块保持不变。 返回值指向确保为任何类型的对象存储正确对齐的存储空间。 获取对一个类型的指针除了之外无效,将使用一个返回值的类型转换。

它是重新分配内存和更改块的对齐的错误。

备注

_aligned_recalloc_dbg 是 _aligned_recalloc 函数的 " debug " 版本。 当 _DEBUG 未定义时,每个调用 _aligned_recalloc_dbg 减少到 _aligned_recalloc的调用。 _aligned_recalloc 和 _aligned_recalloc_dbg 在基堆分配内存,但是, _aligned_recalloc_dbg 满足一些调试功能:在测试块的两侧用户部分的缓冲区对于泄漏、跟踪一个块类型的参数特定分配类型和 filename/linenumber 信息确定分配请求的原点。

_aligned_recalloc_dbg 比可能会更大请求范围 (num * size) 若要重新指派指定的内存块。稍有多个空格或小于最初分配的内存块范围。 调试堆管理器用于附加空间链接调试内存块,并提供应用程序提供调试标题信息并复盖缓冲区。 重新分配可能导致将原始内存堆的其他位置,以及更改的范围内存块。 块的用户部分填充该值 0xCD,并使用缓冲区用 0xFD 填充。

,如果内存分配失败,_aligned_recalloc_dbg 设置 errno 到 ENOMEM ; EINVAL 返回,如果内存需要的数量 (前面提到的包含开销) 超过 _HEAP_MAXREQ。 有关此更改和其他错误代码的信息,请参见 errno、_doserrno、_sys_errlist和_sys_nerr

此外, _aligned_recalloc_dbg 验证其参数。 如果 alignment 不是 2 的次幂,此函数调用的参数无效处理程序,如 参数验证所述。 如果执行允许继续,此函数返回 NULL 并将 errno 到 EINVAL。

有关如何的信息存储在基堆的调试版本中分配,初始化,并管理,请参见 内存管理和调试堆。 有关调用标准堆函数之间的差异的信息与其调试在应用程序的调试版本的版本,请参见 使用调试版本与基版本

要求

实例

必需的头

_aligned_recalloc_dbg

crtdbg.h

有关更多兼容性信息,请参见中介绍的 兼容性

只调试 C 运行库 的版本。

.NET Framework 等效项

不适用。若要调用标准 C 函数,请使用 PInvoke。有关更多信息,请参见 平台调用示例

请参见

参考

调试实例