_aligned_malloc
針對指定的對齊界限配置記憶體。
語法
void * _aligned_malloc(
size_t size,
size_t alignment
);
參數
size
要求的記憶體配置大小。
alignment
對齊值,必須是 2 的整數冪。
傳回值
已配置之記憶體區塊的指標,或為 NULL
(作業失敗時)。 指標是 alignment
的倍數。
備註
_aligned_malloc
是以 malloc
為基礎。
_aligned_malloc
標示 __declspec(noalias)
為 和 __declspec(restrict)
,這表示函式保證不會修改全域變數,且傳回的指標不會有別名。 如需詳細資訊,請參閱 noalias
和 restrict
。
若記憶體配置失敗,或是要求的大小大於 errno
,則此函式會將 ENOMEM
設為 _HEAP_MAXREQ
。 如需 的詳細資訊errno
,請參閱errno
、 _doserrno
_sys_errlist
和 _sys_nerr
。 此外,_aligned_malloc
也會驗證其參數。 如果 alignment
不是 2 或size
零的電源,則此函式會叫用無效的參數處理程式,如參數驗證中所述。 若允許繼續執行,此函式會傳回 NULL
,並將 errno
設為 EINVAL
。
使用 _aligned_free
來解除分配 和 _aligned_offset_malloc
取得的_aligned_malloc
記憶體。 請勿使用 free
,這不會正確回收對齊的記憶體,而且可能會導致難以診斷的錯誤。
根據預設,此函式的全域狀態會限定於應用程式。 若要變更此行為,請參閱 CRT 中的全域狀態。
需求
常式 | 必要的 C 標頭 | C++ 標頭 |
---|---|---|
_aligned_malloc |
<malloc.h> |
<cstdlib> |
範例
// crt_aligned_malloc.c
#include <malloc.h>
#include <stdio.h>
int main() {
void *ptr;
size_t alignment,
off_set;
// Note alignment should be 2^N where N is any positive int.
alignment = 16;
off_set = 5;
// Using _aligned_malloc
ptr = _aligned_malloc(100, alignment);
if (ptr == NULL)
{
printf_s( "Error allocation aligned memory.");
return -1;
}
if (((unsigned long long)ptr % alignment ) == 0)
printf_s( "This pointer, %p, is aligned on %zu\n",
ptr, alignment);
else
printf_s( "This pointer, %p, is not aligned on %zu\n",
ptr, alignment);
// Using _aligned_realloc
ptr = _aligned_realloc(ptr, 200, alignment);
if ( ((unsigned long long)ptr % alignment ) == 0)
printf_s( "This pointer, %p, is aligned on %zu\n",
ptr, alignment);
else
printf_s( "This pointer, %p, is not aligned on %zu\n",
ptr, alignment);
_aligned_free(ptr);
// Using _aligned_offset_malloc
ptr = _aligned_offset_malloc(200, alignment, off_set);
if (ptr == NULL)
{
printf_s( "Error allocation aligned offset memory.");
return -1;
}
if ( ( (((unsigned long long)ptr) + off_set) % alignment ) == 0)
printf_s( "This pointer, %p, is offset by %zu on alignment of %zu\n",
ptr, off_set, alignment);
else
printf_s( "This pointer, %p, does not satisfy offset %zu "
"and alignment %zu\n",ptr, off_set, alignment);
// Using _aligned_offset_realloc
ptr = _aligned_offset_realloc(ptr, 200, alignment, off_set);
if (ptr == NULL)
{
printf_s( "Error reallocation aligned offset memory.");
return -1;
}
if ( ( (((unsigned long long)ptr) + off_set) % alignment ) == 0)
printf_s( "This pointer, %p, is offset by %zu on alignment of %zu\n",
ptr, off_set, alignment);
else
printf_s( "This pointer, %p, does not satisfy offset %zu and "
"alignment %zu\n", ptr, off_set, alignment);
// Note that _aligned_free works for both _aligned_malloc
// and _aligned_offset_malloc. Using free is illegal.
_aligned_free(ptr);
}
This pointer, 3280880, is aligned on 16
This pointer, 3280880, is aligned on 16
This pointer, 3280891, is offset by 5 on alignment of 16
This pointer, 3280891, is offset by 5 on alignment of 16