_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和linenumber參數才可以使用的時機_malloc_dbg明確地呼叫或 _CRTDBG_MAP_ALLOC 巳經定義了前置處理器常數。
傳回值
成功地完成,這個函式會傳回使用者部份的配置的記憶體區塊的指標、 呼叫新的處理常式函式,則傳回 NULL。 傳回的行為的完整說明,請參閱下列的 < 備註 > 一節。 如需有關如何使用新的處理常式函式的詳細資訊,請參閱 malloc 函式。
備註
_malloc_dbg偵錯版本的 malloc 函式。 當 _DEBUG 沒有定義,每次呼叫_malloc_dbg將減少以呼叫malloc。 兩者都malloc和_malloc_dbg配置的基底的堆集 」 中的記憶體區塊,但_malloc_dbg提供了數個偵錯功能: 任一邊的使用者區塊的部份若要測試是否有裂縫,來追蹤特定的配置類型的區塊型別參數的緩衝區和filename/linenumber資訊來判斷配置要求的原點。
_malloc_dbg配置記憶體區塊,具有比要求稍微多一點空間size。 額外的空間用於偵錯堆積管理員若要連結的偵錯記憶體區塊,並提供偵錯標頭資訊給應用程式,並覆寫緩衝區。 當配置區塊時,使用者區塊的部份填滿 0xCD 的值,而每個覆寫緩衝區會填入 0xFD。
_malloc_dbg設定errno到ENOMEM記憶體配置失敗時,或所需的記憶體 (包括先前所述的額外負荷) 量超過_HEAP_MAXREQ。 如需這和其他錯誤碼資訊,請參閱errno、 _doserrno、 _sys_errlist 和 _sys_nerr。
如需有關如何記憶體區塊會配置、 初始化,而且在基底堆積的偵錯版本管理的資訊,請參閱記憶體管理和偵錯堆積。
配置的區塊型別和它們的使用方式的相關資訊,請參閱類型的區塊在偵錯堆積上。
需求
常式 |
所需的標頭 |
---|---|
_malloc_dbg |
<crtdbg.h> |
如需相容性資訊,請參閱相容性在簡介中。
文件庫
偵錯版本的 C 執行階段程式庫只。
範例
範例中,如何使用_malloc_dbg,請參閱 crt_dbg1。
.NET Framework 對等用法
不適用。 若要呼叫標準的 c 函式,使用PInvoke。 如需詳細資訊,請參閱平台叫用範例。