_CrtMemDumpAllObjectsSince
プログラムの実行開始時以降または指定されたヒープ状態以降のヒープ内のオブジェクトについての情報をダンプします (デバッグ バージョンのみ)。
構文
void _CrtMemDumpAllObjectsSince(
const _CrtMemState *state
);
パラメーター
state
ダンプの開始または NULLを開始するヒープ状態へのポインター。
解説
_CrtMemDumpAllObjectsSince 関数は、ヒープに割り当てられたオブジェクトのデバッグ ヘッダー情報をユーザーが判読できる形式でダンプします。 ダンプ情報は、割り当ての追跡とメモリの問題の検出のためにアプリケーションで使用できます。 _DEBUG が定義されていない場合、_CrtMemDumpAllObjectsSince の呼び出しは前処理で削除されます。
_CrtMemDumpAllObjectsSince は state パラメーターの値を使用して、ダンプ操作の開始点を判断します。 指定したヒープ状態からダンプを開始するには、state パラメーターは、_CrtMemDumpAllObjectsSinceが呼び出される前に_CrtMemCheckpointによって入力された_CrtMemState構造体へのポインターである必要があります。 stateがNULLされると、関数はプログラムの実行の開始時からダンプを開始します。
アプリケーションが_CrtSetDumpClientを呼び出してダンプ フック関数をインストールした場合、_CrtMemDumpAllObjectsSince_CLIENT_BLOCKタイプのブロックに関する情報をダンプするたびに、アプリケーション指定のダンプ関数も呼び出されます。 既定では、内部 C ランタイム ブロック (_CRT_BLOCK) は、メモリ ダンプ操作に含まれません。 _CrtSetDbgFlag関数を使用して、_crtDbgFlagの_CRTDBG_CHECK_CRT_DF ビットをオンにして、これらのブロックを含めることができます。 さらに、解放済みまたは無視済みとしてマークされたブロック (_FREE_BLOCK、 _IGNORE_BLOCK) はメモリ ダンプに含まれません。
ヒープ状態関数と _CrtMemState 構造体について詳しくは、「ヒープ状態レポート関数」をご覧ください。 デバッグ バージョンのベース ヒープでのメモリ ブロックの割り当て、初期化、管理の方法について詳しくは、「CRT デバッグ ヒープの詳細」を参照してください。
要件
| ルーチンによって返される値 | 必須ヘッダー |
|---|---|
| _CrtMemDumpAll-ObjectsSince | <crtdbg.h> |
互換性の詳細については、「 Compatibility」を参照してください。
ライブラリ
C ランタイム ライブラリのデバッグ バージョンのみ。
例
_CrtMemDumpAllObjectsSince の使用方法のサンプルについては、「crt_dbg2」を参照してください。