_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
为空指针或 alignment
不是 2 的幂,则 _aligned_msize
会调用无效参数句柄,如参数验证中所述。 如果处理了错误,则该函数将 errno
设置为 EINVAL
并返回 -1。
默认情况下,此函数的全局状态范围限定为应用程序。 若要更改此行为,请参阅 CRT 中的全局状态。
要求
例程 | 必需的标头 |
---|---|
_aligned_msize |
<malloc.h> |
有关兼容性的详细信息,请参阅 兼容性。
库
C 运行时库的所有版本。