_aligned_recalloc_dbg
_aligned_malloc 또는 _aligned_offset_malloc를 사용하여 할당된 메모리 블록의 크기를 변경하고 메모리를 0으로 초기화합니다(디버그 버전에만 해당).
void * _aligned_recalloc_dbg( void * memblock, size_t num, size_t size, size_t alignment, const char *filename, int linenumber );
매개 변수
[in] memblock
현재 메모리 블록 포인터입니다.[in] num
요소의 수입니다.[in] size
각 요소의 크기입니다(바이트).[in] alignment
맞춤 값으로 2의 정수 거듭제곱이어야 합니다.[in] filename
할당 작업 또는 NULL을 요청한 소스 파일의 이름에 대한 포인터입니다.[in] linenumber
할당 작업이 요청되었거나 NULL인 소스 파일의 줄 번호입니다.
반환 값
_aligned_recalloc_dbg는 다시 할당된(그리고 이동되었을 수 있는) 메모리 블록에 대한 void 포인터를 반환합니다. 크기가 0이고 버퍼 인수가 NULL이 아닌 경우 또는 버퍼를 지정된 크기로 확장하는 데 사용할 수 있는 메모리가 부족한 경우 반환 값은 NULL입니다. 첫 번째 경우 원래 블록이 해제됩니다. 두 번째 경우 원래 블록은 변경되지 않습니다. 반환 값은 모든 형식의 개체 저장을 위해 적절하게 맞도록 보장되어 있는 저장소 공간을 가리킵니다. void가 아닌 형식의 포인터를 얻으려면 반환 값에 형식 캐스팅을 사용합니다.
메모리를 다시 할당하고 블록의 맞춤을 변경하면 오류가 발생합니다.
설명
_aligned_recalloc_dbg는 _aligned_recalloc 함수의 디버그 버전입니다. _DEBUG를 정의하지 않은 경우 _aligned_recalloc_dbg에 대한 각 호출이 _aligned_recalloc에 대한 호출로 줄어듭니다. _aligned_recalloc와 _aligned_recalloc_dbg 둘 다 기본 힙에서 메모리 블록을 다시 할당하지만 _aligned_recalloc_dbg는 여러 디버깅 기능을 수용합니다. 이러한 기능에는 메모리 블록의 사용자 부분 한 쪽에서의 버퍼(어느 쪽이든지 상관없이)로 누수 테스트, 블록 형식 매개 변수로 특정 할당 형식 추적 및 filename/linenumber 정보로 할당 요청의 원점을 확인하는 기능이 있습니다.
_aligned_recalloc_dbg는 요청된 크기(num * size)보다 약간 더 많은 공간을 지정된 메모리 블록에 다시 할당합니다. 이때 요청된 크기는 원래 할당된 메모리 블록의 크기보다 더 크거나 작을 수 있습니다. 디버그 힙 관리자는 추가 공간을 사용하여 디버그 메모리 블록을 연결하고 응용 프로그램에 디버그 헤더 정보를 제공하고 버퍼를 덮어씁니다. 다시 할당하면 원래 메모리 블록이 힙의 다른 위치로 이동하고 메모리 블록의 크기가 변할 수 있습니다. 블록의 사용자 부분은 값 0xCD로 채워지고 덮어쓰기 버퍼는 0xFD로 채워집니다.
메모리 할당에 실패하면 _aligned_recalloc_dbg는 errno를 ENOMEM으로 설정하고 필요한 메모리 양(앞에서 언급한 오버헤드 포함)이 _HEAP_MAXREQ를 초과하면 EINVAL이 반환됩니다. 이러한 오류 코드 및 기타 오류 코드에 대한 자세한 내용은 errno, _doserrno, _sys_errlist 및 _sys_nerr을 참조하세요.
또한 _aligned_recalloc_dbg는 매개 변수의 유효성을 검사합니다. alignment가 2의 거듭제곱이 아니면 이 함수는 매개 변수 유효성 검사에서 설명된 대로 잘못된 매개 변수 처리기를 호출합니다. 계속해서 실행하도록 허용한 경우 이 함수는 NULL을 반환하고 errno를 EINVAL로 설정합니다.
기본 힙의 디버그 버전에서 메모리 블록을 할당, 초기화 및 관리하는 방법에 대한 자세한 내용은 CRT 디버그 힙 정보를 참조하세요. 할당 블록 형식과 이러한 형식의 사용 방법에 대한 자세한 내용은 디버그 힙의 블록 형식을 참조하세요. 응용 프로그램의 디버그 빌드 시 표준 힙 함수와 이 함수의 디버그 버전 호출 간의 차이점에 대한 자세한 내용은 힙 할당 함수의 디버그 버전을 참조하세요.
요구 사항
루틴 |
필수 헤더 |
|---|---|
_aligned_recalloc_dbg |
<crtdbg.h> |
호환성에 대한 자세한 내용은 소개 단원의 호환성 부분을 참조하십시오.
라이브러리
디버그 버전의 유일한 C 런타임 라이브러리입니다.
해당 .NET Framework 항목
해당 사항 없음. 표준 C 함수를 호출하려면 PInvoke를 사용합니다. 자세한 내용은 플랫폼 호출 예제를 참조하십시오.