_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。
只有在已明確呼叫 _malloc_dbg，或是已定義 _CRTDBG_MAP_ALLOC 處理器常數時，才可以使用 filename 和 linenumber 參數。
傳回值
成功完成時，此函式會傳回重新配置記憶體區塊後的使用者部分的指標，呼叫新的處理常式函式，或是傳回 NULL。 如需傳回行為的完整說明，請參閱下列＜備註＞一節。 如需如何使用新的處理常式函式的詳細資訊，請參閱 malloc 函式。
備註
_malloc_dbg 是偵錯版本的 malloc 函式。 當 _DEBUG 未定義時，每個 _malloc_dbg 的呼叫會降至 malloc 的呼叫。 malloc 和 _malloc_dbg 都會配置基底堆積中的記憶體區塊，但 _malloc_dbg 還提供數種偵錯功能：在區塊的使用者部分的任一端使用緩衝區以測試遺漏，以及追蹤特定配置類型的區塊類型參數，還有判斷配置要求來源的 filename/linenumber 資訊。
_malloc_dbg 會使用比要求的 size 稍多一些的空間配置記憶體區塊。 偵錯堆積管理員會使用額外的空間連結偵錯記憶體區塊，以及為應用程式提供偵錯標頭資訊和覆寫緩衝區。 區塊配置後，區塊的使用者部分會填入值 0xCD，且每個覆寫緩衝區會填入 0xFD。
若記憶體配置失敗，或是所需的記憶體數量 (包含之前提到的額外負荷) 超過 _HEAP_MAXREQ，_malloc_dbg 會將 errno 設定為 ENOMEM。 如需此錯誤碼及其他錯誤碼的詳細資訊，請參閱 errno、_doserrno、_sys_errlist 和 _sys_nerr。
如需在偵錯版本的基底堆積中如何配置、初始化及管理記憶體區塊的資訊，請參閱 CRT 偵錯堆積詳細資料。 如需配置區塊類型以及如何使用它們的詳細資訊，請參閱偵錯堆積上的區塊類型。 如需在應用程式的偵錯組建中呼叫標準堆積函式以及其偵錯版本之間的差異的資訊，請參閱堆積配置函式的偵錯版本。
需求
常式 |
必要的標頭 |
|---|---|
_malloc_dbg |
<crtdbg.h> |
如需相容性詳細資訊，請參閱簡介中的相容性。
程式庫
僅限偵錯版本的 C 執行階段程式庫。
範例
如需使用 _malloc_dbg 的範例，請參閱 crt_dbg1。
.NET Framework 對等用法
不適用。若要呼叫標準 C 函式，請使用 PInvoke。如需詳細資訊，請參閱平台叫用範例。