_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 構造体の詳細については、「Heap State Reporting Functions (ヒープの状態をレポートする関数)」を参照してください。 デバッグ バージョンのベース ヒープに対するメモリ ブロックの割り当て、初期化、管理方法の詳細については、「CRT デバッグ ヒープ」を参照してください。
必要条件
ルーチン |
必須ヘッダー |
省略可能なヘッダー |
|---|---|---|
_CrtMemDumpStatistics |
<crtdbg.h> |
<errno.h> |
互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。
ライブラリ:CRT ライブラリの機能 のデバッグ バージョンのみ。
使用例
「crt_dbg1」を参照してください。