_recalloc_dbg

  • 發行項

重新配置陣列，並將其項目初始化為 0 (僅限偵錯版本)。

語法

void *_recalloc_dbg(
   void *userData,
   size_t num,
   size_t size,
   int blockType,
   const char *filename,
   int linenumber
);

參數

userData
之前配置的記憶體區塊的指標。

number
要求的記憶體區塊數。

size
要求的每個記憶體區塊大小 (位元組)。

blockType
要求的記憶體區塊類型：_CLIENT_BLOCK 或 _NORMAL_BLOCK。

如需配置區塊類型及其使用方式的相關資訊，請參閱 偵錯堆積 上的區塊類型。

filename
要求配置作業之原始程式檔的名稱的指標，或為 NULL。

linenumber
原始程式檔中的行號，其中要求配置作業，或為 NULL。

filename只有在明確呼叫 或 _CRTDBG_MAP_ALLOC 定義預處理器常數時 _recalloc_dbg ，才能使用 和 linenumber 參數。

傳回值

成功完成時，此函式會傳回重新配置記憶體區塊之使用者部分的指標、呼叫新的處理常式函式，或傳 NULL 回 。 如需傳回行為的完整說明，請參閱下列＜備註＞一節。 如需如何使用新處理常式函式的詳細資訊，請參閱 函式 _recalloc 。

備註

_recalloc_dbg 是函式 _recalloc 的偵錯版本。 未定義 時 _DEBUG ，對 的每個呼叫 _recalloc_dbg 都會縮減為 對 _recalloc 的呼叫。 _recalloc 和 _recalloc_dbg 都會重新配置基底堆積中的記憶體區塊，但 _recalloc_dbg 還容納數種偵錯功能：在區塊的使用者部分的任一端使用緩衝區以測試遺漏，以及追蹤特定配置類型的區塊類型參數，還有判斷配置要求來源的 filename/linenumber 資訊。

_recalloc_dbg 會使用比要求的大小還要稍微多一些的空間重新配置指定的記憶體區塊 (number * size)，而要求的大小可能會比原始配置的記憶體區塊大小更大或更小。 偵錯堆積管理員會使用額外的空間來連結偵錯記憶體區塊，並提供偵錯標頭資訊和覆寫緩衝區的應用程式。 重新配置可能會導致將原始記憶體區塊移至堆積中的不同位置，以及變更記憶體區塊的大小。 區塊的使用者部分會填入值 0xCD，且每個覆寫緩衝區會填入 0xFD。

若記憶體配置失敗，_recalloc_dbg 會將 errno 設定為 ENOMEM；若所需的記憶體數量 (包含之前提到的額外負荷) 超過 EINVAL，則會傳回 _HEAP_MAXREQ。 如需此錯誤碼和其他錯誤碼的相關資訊，請參閱 errno 、 _doserrno_sys_errlist 和 _sys_nerr 。

如需如何在基底堆積偵錯版本中配置、初始化及管理記憶體區塊的相關資訊，請參閱 CRT 偵錯堆積詳細資料 。 如需有關標準堆積函式與偵錯版本差異的資訊，請參閱 堆積配置 函式的偵錯版本。

需求

常式 必要的標頭
_recalloc_dbg <crtdbg.h>

如需相容性詳細資訊，請參閱相容性。

程式庫

僅限偵錯版本的 C 執行階段程式庫。

另請參閱

偵錯常式