_CrtMemDifference
比較兩個記憶體狀態並傳回其差異 (僅限偵錯版本)。
語法
int _CrtMemDifference(
_CrtMemState *stateDiff,
const _CrtMemState *oldState,
const _CrtMemState *newState
);
參數
stateDiff
用來儲存兩個記憶體狀態 (已傳回) 之間差異的 _CrtMemState
結構指標。
oldState
較舊記憶體狀態 (_CrtMemState
結構) 的指標。
newState
較新記憶體狀態 (_CrtMemState
結構) 的指標。
傳回值
如果記憶體狀態的差異很大, _CrtMemDifference
則傳 TRUE
回 。 否則,此函式會傳回 FALSE
。
備註
函 _CrtMemDifference
式會 oldState
比較和 newState
並儲存其差異 stateDiff
,然後應用程式可以使用它來偵測記憶體流失和其他記憶體問題。 若未定義 _DEBUG
,將會在前置處理期間移除對 _CrtMemDifference
的呼叫。
newState
和 oldState
必須是 結構的有效指標 _CrtMemState
,定義於 中 crtdbg.h
,在 _CrtMemCheckpoint
呼叫 _CrtMemDifference
之前已填入 。 stateDiff
必須是先前配置之 _CrtMemState
結構執行個體的指標。 如果 stateDiff
、 newState
或 oldState
為 NULL
,則會叫用無效的參數處理程式,如參數驗證中所述。 如果允許繼續執行,errno
則會將、_doserrno
、 _sys_errlist
和 _sys_nerr
設定為 ,EINVAL
且函式會傳FALSE
回 。
_CrtMemDifference
會將 _CrtMemState
中 oldState
區塊的域值與 中的 newState
欄位值進行比較,並將結果儲存在 中 stateDiff
。 當配置區塊類型的數目或每個類型的已配置區塊總數在兩個記憶體狀態之間有所不同時,狀態的差異會被視為顯著。 曾經配置給這兩個狀態的最大數量之間的差異,以及配置給這兩個狀態的總數之間的差異也會儲存在 stateDiff
中。
根據預設,內部 C 運行時間區塊 (_CRT_BLOCK
) 不會包含在記憶體狀態作業中。 函 _CrtSetDbgFlag
式可用來開啟 _CRTDBG_CHECK_CRT_DF
的位 _crtDbgFlag
,以將這些區塊包含在洩漏偵測和其他記憶體狀態作業中。 釋放的記憶體區塊 (_FREE_BLOCK
) 不會造成 _CrtMemDifference
傳回 TRUE
。
如需堆積狀態函式及 _CrtMemState
結構的詳細資訊,請參閱堆積狀態報告函式 (部分機器翻譯)。 如需如何在基底堆積偵錯版本中配置、初始化及管理記憶體區塊的相關信息,請參閱 CRT 偵錯堆積詳細數據。
需求
常式 | 必要的標頭 | 選擇性標頭 |
---|---|---|
_CrtMemDifference |
<crtdbg.h> |
<errno.h> |
如需相容性詳細資訊,請參閱相容性。
程式庫:僅限偵錯版本的 C 執行階段程式庫。