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