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