_CrtMemDumpStatistics

  • [アーティクル]

指定されたヒープ状態のデバッグ ヘッダー情報をユーザーが判読できる形式でダンプします (デバッグ バージョンのみ)。

構文

void _CrtMemDumpStatistics(
   const _CrtMemState *state
);

パラメーター

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

解説

_CrtMemDumpStatistics 関数は、ヒープの指定された状態のデバッグ ヘッダー情報をユーザーが判読できる形式でダンプします。 ダンプ統計情報は、割り当ての追跡とメモリの問題の検出のためにアプリケーションで使用できます。 メモリ状態には、特定のヒープ状態、または 2 つの状態の相違点を含めることができます。 _DEBUG が定義されていない場合、_CrtMemDumpStatistics の呼び出しは前処理で削除されます。

state パラメーターは、_CrtMemDumpStatistics が呼び出される前に _CrtMemCheckpoint によってデータが格納されたか、_CrtMemDifference によって返された、_CrtMemState 構造体へのポインターである必要があります。 state が NULL の場合は、「パラメーターの検証」で説明されているように、無効なパラメーター ハンドラーが呼び出されます。 実行の継続が許可された場合、errno が EINVAL に設定され、何も実行されません。 詳細については、「errno」、「_doserrno」、「_sys_errlist」、および「_sys_nerr」を参照してください。

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

要件

ルーチンによって返される値 必須ヘッダー 省略可能なヘッダー
_CrtMemDumpStatistics <crtdbg.h> <errno.h>

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

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

関連項目

デバッグ ルーチン