_CrtMemDumpAllObjectsSince
從程式執行一開始,或從指定的堆積狀態傾印堆積中物件的相關資訊 (僅限偵錯版本)。
語法
void _CrtMemDumpAllObjectsSince(
const _CrtMemState *state
);
參數
state
要開始從 或 NULL
傾印的堆積狀態指標。
備註
_CrtMemDumpAllObjectsSince
函式會以使用者可讀格式傾印堆積中所配置之物件的偵錯標頭資訊。 應用程式會使用此傾印資訊追蹤配置及偵測記憶體問題。 若未定義 _DEBUG
,將會在前置處理期間移除對 _CrtMemDumpAllObjectsSince
的呼叫。
_CrtMemDumpAllObjectsSince
使用 state
參數的值來判斷起始傾印作業的位置。 若要開始從指定的堆積狀態傾印,state
參數必須是呼叫之前_CrtMemDumpAllObjectsSince
已填入_CrtMemCheckpoint
之 結構的指標_CrtMemState
。 當 為 NULL
時state
,函式會從程序執行開始開始傾印。
如果應用程式已藉由呼叫 _CrtSetDumpClient
來安裝傾印攔截函式,則每次 _CrtMemDumpAllObjectsSince
傾印有關區塊 _CLIENT_BLOCK
類型的資訊時,也會呼叫應用程式提供的傾印函式。 根據預設,內部 C 運行時間區塊 (_CRT_BLOCK
) 不會包含在記憶體轉儲作業中。 函 _CrtSetDbgFlag
式可用來開啟 _CRTDBG_CHECK_CRT_DF
的 _crtDbgFlag
位元,以包含這些區塊。 此外,標示為已釋放或忽略的_FREE_BLOCK
_IGNORE_BLOCK
區塊不會包含在記憶體轉儲中。
如需堆積狀態函式及 _CrtMemState
結構的詳細資訊,請參閱堆積狀態報告函式 (部分機器翻譯)。 如需在偵錯版之基底堆積中如何配置、初始化及管理記憶體區塊的詳細資訊,請參閱 CRT 偵錯堆積詳細資料 (部分機器翻譯)。
需求
常式 | 必要的標頭 |
---|---|
_CrtMemDumpAll-ObjectsSince | <crtdbg.h> |
如需相容性詳細資訊,請參閱相容性。
程式庫
僅限偵錯版本的 C 執行階段程式庫。
範例
如需如何使用 _CrtMemDumpAllObjectsSince
的範例,請參閱 crt_dbg2
。