共用方式為


_malloc_dbg

在堆積中配置記憶體區塊,其中包含偵錯標頭的額外空間,並覆寫緩衝區(僅限偵錯版本)。

語法

void *_malloc_dbg(
   size_t size,
   int blockType,
   const char *filename,
   int linenumber
);

參數

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

blockType
要求的記憶體區塊類型:_CLIENT_BLOCK_NORMAL_BLOCK

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

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

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

傳回值

成功完成時,此函式會傳回已設定記憶體區塊之使用者部分的指標、呼叫新的處理程式函式,或傳 NULL回 。 如需傳回行為的完整說明,請參閱下列<備註>一節。 如需如何使用新處理程式函式的詳細資訊,請參閱 函式 malloc

備註

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

_malloc_dbg 會使用比要求的 size 稍多一些的空間配置記憶體區塊。 偵錯堆積管理員會使用額外的空間來連結偵錯記憶體區塊,並提供偵錯標頭資訊和覆寫緩衝區的應用程式。 配置區塊時,區塊的使用者部分會填入值0xCD,而且每個覆寫緩衝區都會填入0xFD。

若記憶體配置失敗,或是所需的記憶體數量 (包含之前提到的額外負荷) 超過 _malloc_dbgerrno 會將 ENOMEM 設定為 _HEAP_MAXREQ。 如您需要此錯誤碼和其他錯誤碼的相關資訊,請參閱errno_doserrno_sys_errlist_sys_nerr

如需如何在基底堆積偵錯版本中配置、初始化及管理記憶體區塊的相關信息,請參閱 CRT 偵錯堆積詳細數據。 如需配置區塊類型及其使用方式的相關信息,請參閱 偵錯堆積上的區塊類型。 如需有關標準堆積函式與偵錯版本差異的資訊,請參閱 堆積配置函式的偵錯版本。

需求

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

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

程式庫

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

範例

如需如何使用 _malloc_dbg的範例,請參閱 crt_dbg1

另請參閱

偵錯常式
malloc
_calloc_dbg