_CrtMemDumpStatistics
以使用者可閱讀的格式,為指定的堆積狀態傾印偵錯標頭資訊 (僅偵錯版本)。
void _CrtMemDumpStatistics(
const _CrtMemState *state
);
參數
- state
對傾印的堆積狀態之指標。
備註
_CrtMemDumpStatistics 函式以使用者可閱讀的格式傾印堆積的指定狀態之偵錯標頭資訊。 傾印統計資料可以由應用程式追蹤組態和偵測記憶體問題時使用。 記憶體狀態可能包含特定的堆積狀態或兩個狀態之間的差異。 如果未定義 _DEBUG,在前置處理中,對 _CrtMemDumpStatistics 的呼叫將被移除。
state 參數必須是在呼叫 _CrtMemDumpStatistics 之前,指向由 _CrtMemCheckpoint 填入或由 _CrtMemDifference 傳回的 _CrtMemState 結構之指標。 如果 state 是 NULL,則叫用無效參數處理常式,如 參數驗證 中所述。 如果允許繼續執行,errno將被設定為 EINVAL 且不採取任何行動。 如需詳細資訊,請參閱errno、_doserrno、_sys_errlist 和 _sys_nerr。
如需堆積狀態的函式和 _CrtMemState 結構的詳細資訊,請參閱 堆積狀態回報函式。 如需記憶體區塊配置、初始化的方式,並在基底堆積的偵錯版本管理記憶體區塊的更多詳細資訊,請參閱 CRT 偵錯堆積詳細資料。
需求
常式 |
必要的標頭 |
選擇性的標頭檔 |
---|---|---|
_CrtMemDumpStatistics |
<crtdbg.h> |
<errno.h> |
如需詳細資訊,請參閱介紹中的 相容性 。
程式庫: 僅 CRT 程式庫功能 之偵錯版本。
範例
請參閱 crt_dbg1。