通过

_aligned_offset_recalloc

  • 项目

更改分配 _aligned_malloc 或 _aligned_offset_malloc 存储区的大小和内存初始化为 0。

void * _aligned_offset_recalloc(
   void *memblock, 
   size_t num, 
   size_t size, 
   size_t alignment,
   size_t offset
);

参数

  • memblock
    当前内存块的指针。

  • num
    元素的数目

  • size
    每个元素字节长度。

  • alignment
    对齐值必须是2的整数次幂。

  • offset
    强制对齐内存分配中的偏移量。

返回值

_aligned_offset_recalloc 返回一无效指针用来重分配的 (可能移动）内存块。 如果大小为零，则返回值为 NULL，并且缓冲区参数不为 NULL，或者如果，没有足够的可用内存块来扩展特定大小的块。 在第一种情况下，释放原始块。 在第二种情况下，原始块是不变。 返回值指向保证适当地存储任何类型的对象的对齐的存储空间。 若要获取指向类型的指针而不是void，请对返回值使用类型转换。

_aligned_offset_recalloc 标记为 __declspec(noalias) 和 __declspec(restrict)；这意味着函数保证不修改全局变量，和返回的指针不用做别名。 有关更多信息，请参见 没有别名 和 限制。

备注

类似于_aligned_offset_malloc，_aligned_offset_recalloc 允许结构对齐在结构中的偏移量。

_aligned_offset_recalloc 基于 malloc。 有关使用 _aligned_offset_malloc 的详细信息，请参见malloc。 如果 memblock 为 NULL，则函数调用内部的 _aligned_offset_malloc。

如果内存分配失败或是如果请求的大小(num * size) 比 _HEAP_MAXREQ 更大，则函数将 ENOMEM 设置为 errno。 有关 errno的更多信息，请参见errno、_doserrno、_sys_errlist 和 _sys_nerr。 此外，_aligned_offset_recalloc 验证其参数。 如果 alignment 不是2的幂次或是如果 offset 大于等于请求的大小和非零，这函数调用无效参数处理程序，就如 参数验证 描述的。 如果允许执行继续，则这函数返回 NULL 并将 errno 设置为 EINVAL。

要求

例程

必需的标头

_aligned_offset_recalloc

<malloc.h>

.NET Framework 等效项

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

请参见

参考

数据对齐

_recalloc

_aligned_recalloc