_aligned_msize

返回在堆中分配的存储块的大小。

语法

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

参数

memblock
指向内存块的指针。

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

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

返回值

返回无符号整数形式的大小(以字节为单位)。

注解

_aligned_msize 函数返回调用 _aligned_malloc_aligned_realloc 分配的内存块的大小(以字节为单位)。 alignmentoffset 值必须与传递给分配该块的函数的值相同。

当应用程序与调试版的 C 运行时库链接时,_aligned_msize 将解析为 _aligned_msize_dbg。 有关在调试过程中如何托管堆的详细信息,请参阅 CRT 调试堆

此函数验证其参数。 如果 memblock 为空指针或 alignment 不是 2 的幂,则 _aligned_msize 会调用无效参数句柄,如参数验证中所述。 如果处理了错误,则该函数将 errno 设置为 EINVAL 并返回 -1。

默认情况下,此函数的全局状态范围限定为应用程序。 若要更改此行为,请参阅 CRT 中的全局状态

要求

例程 必需的标头
_aligned_msize <malloc.h>

有关兼容性的详细信息,请参阅 兼容性

C 运行时库的所有版本。

另请参阅

内存分配