_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 執行時間程式庫 的版本。

另請參閱

偵錯常式
_crtDbgFlag