_CrtMemDumpStatistics
指定されたヒープ状態のデバッグ ヘッダー情報をユーザーが読める形式でダンプします (デバッグ バージョンだけ)。
void _CrtMemDumpStatistics(
const _CrtMemState *state
);
パラメーター
- state
ダンプするヒープ状態へのポインター。
解説
_CrtMemDumpStatistics 関数は、指定されたヒープ状態のデバッグ ヘッダー情報をユーザーが読むことができる形式でダンプします。 アプリケーションは、ダンプ情報を使用して、メモリ割り当ての追跡やメモリに関する問題の検出を行うことができます。 メモリ状態には、特定のヒープ状態または 2 つの状態の差分が含まれる場合があります。 _DEBUG が未定義の場合、_CrtMemDumpStatistics の呼び出しはプリプロセスで削除されます。
state パラメーターは、_CrtMemCheckpoint で値が入力されるか、または _CrtMemDumpStatistics が呼び出される前に _CrtMemDifference によって返される _CrtMemState 構造体へのポインターである必要があります。 state が NULL の場合は、「パラメーターの検証」に説明されているように、無効なパラメーター ハンドラーが呼び出されます。 実行の継続が許可された場合、errno が EINVAL に設定され、何も実行されません。 詳細については、「errno、_doserrno、_sys_errlist、および _sys_nerr」を参照してください。
ヒープ状態関数と _CrtMemState 構造体の詳細については、「ヒープの状態をレポートする関数」を参照してください。 デバッグ バージョンのベース ヒープに対するメモリ ブロックの割り当て、初期化、管理方法の詳細については、「メモリ管理とデバッグ ヒープ」を参照してください。
必要条件
ルーチン |
必須ヘッダー |
省略可能なヘッダー |
|---|---|---|
_CrtMemDumpStatistics |
<crtdbg.h> |
<errno.h> |
互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。
**ライブラリ:**デバッグ バージョンのC ランタイム ライブラリのみ。
使用例
「crt_dbg1 サンプル : C ランタイムの基本的なデバッグ機能」を参照してください。
同等の .NET Framework 関数
System.Diagnostics.PerformanceCounter