_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자세한 내용은 , , _doserrno_sys_errlist및_sys_nerr 를 참조하세요errno. 또한 _aligned_malloc는 매개 변수의 유효성을 검사합니다. 2의 힘이 아니거나 size 0인 경우 alignment 이 함수는 매개 변수 유효성 검사에 설명된 대로 잘못된 매개 변수 처리기를 호출합니다. 계속해서 실행하도록 허용한 경우 이 함수는 NULL을 반환하고 errno를 EINVAL로 설정합니다.
둘 다 _aligned_malloc 에서 가져온 메모리의 할당을 취소하는 _aligned_offset_malloc데 사용합니다_aligned_free. 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