_CrtMemDumpAllObjectsSince

  • [アーティクル]

プログラムの実行開始時以降または指定されたヒープ状態以降のヒープ内のオブジェクトについての情報をダンプします (デバッグ バージョンのみ)。

構文

void _CrtMemDumpAllObjectsSince(
   const _CrtMemState *state
);

パラメーター

state
ダンプを開始するヒープ状態へのポインター。NULL

解説

_CrtMemDumpAllObjectsSince 関数は、ヒープに割り当てられたオブジェクトのデバッグ ヘッダー情報をユーザーが判読できる形式でダンプします。 ダンプ情報は、割り当ての追跡とメモリの問題の検出のためにアプリケーションで使用できます。 _DEBUG が定義されていない場合、_CrtMemDumpAllObjectsSince の呼び出しは前処理で削除されます。

_CrtMemDumpAllObjectsSince は state パラメーターの値を使用して、ダンプ操作の開始点を判断します。 指定したヒープ状態からダンプを開始するには、パラメーターは、state以前_CrtMemDumpAllObjectsSinceに呼び出された_CrtMemCheckpoint構造体への_CrtMemStateポインターである必要があります。 このNULL場合state、関数はプログラム実行の開始時からダンプを開始します。

アプリケーションが呼び出_CrtSetDumpClientしによってダンプ フック関数をインストールした場合、ブロックの種類に関する情報を_CLIENT_BLOCKダンプするたびに_CrtMemDumpAllObjectsSince、アプリケーション指定のダンプ関数も呼び出されます。 既定では、内部 C ランタイム ブロック (_CRT_BLOCK) は、メモリ ダンプ操作に含まれません。 この _CrtSetDbgFlag 関数を使用して、これらのブロックを _CRTDBG_CHECK_CRT_DF 含めるビット _crtDbgFlag をオンにすることができます。 また、解放済みまたは無視済み (_FREE_BLOCK,) としてマークされたブロックは、 _IGNORE_BLOCKメモリ ダンプには含まれません。

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

必要条件

ルーチンによって返される値 必須ヘッダー
_CrtMemDumpAll-ObjectsSince <crtdbg.h>

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

ライブラリ

C ランタイム ライブラリのデバッグ バージョンのみ。

例

_CrtMemDumpAllObjectsSince の使用方法のサンプルについては、「crt_dbg2」を参照してください。

関連項目

デバッグ ルーチン
_crtDbgFlag