_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 ランタイム ライブラリのデバッグ バージョンのみ。