_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

참고 항목

데이터 맞춤