_CrtMemCheckpoint

  • [アーティクル]

デバッグ ヒープの現在の状態を取得し、アプリケーションが指定した _CrtMemState 構造体に格納します (デバッグ バージョンだけ)。

構文

void _CrtMemCheckpoint(
   _CrtMemState *state
);

パラメーター

state
メモリのチェックポイントを格納する _CrtMemState 構造体へのポインター。

解説

_CrtMemCheckpoint 関数は、指定された時点のデバッグ ヒープの状態のスナップショットを作成します。 このスナップショットは、メモリ リークやその他の問題の検出に役立つなど_CrtMemDifference、他のヒープ状態関数で使用できます。 _DEBUG が定義されていない場合、_CrtMemState の呼び出しは前処理で削除されます。

_CrtMemState パラメーターには、Crtdbg.h で定義されている state 構造体の割り当て済みインスタンスへのポインターを渡す必要があります。 チェックポイントの作成時に _CrtMemCheckpoint でエラーが発生すると、 _CRT_WARN デバッグ レポートが生成され、問題が表示されます。

ヒープ状態関数と_CrtMemState構造の詳細については、「ヒープ状態レポート関数」を参照してください。 ベース ヒープのデバッグ バージョンでのメモリ ブロックの割り当て、初期化、および管理方法の詳細については、「CRT デバッグ ヒープの詳細」を参照してください。

有効な場合stateはNULL、「パラメーターの検証」の説明に従って、無効なパラメーター ハンドラーが呼び出されます。 実行の続行が許可され、 errno, , _doserrno, _sys_errlistが _sys_nerr 設定 EINVAL され、関数が返されます。

必要条件

ルーチンによって返される値 必須ヘッダー
_CrtMemCheckpoint <crtdbg.h>、<errno.h>

互換性の詳細については、「 Compatibility」を参照してください。

ライブラリ: UCRT のデバッグ バージョンのみ。

関連項目

デバッグ ルーチン
_CrtMemDifference