_CrtCheckMemory
デバッグ ヒープで割り当てられたメモリ ブロックの整合性を確認します (デバッグ バージョンのみ)。
構文
int _CrtCheckMemory( void );
戻り値
成功した場合、 _CrtCheckMemory は TRUEを返します。それ以外の場合、関数は FALSEを返します。
解説
_CrtCheckMemory 関数は、基になるベース ヒープを確認し、各メモリ ブロックを調べることにより、デバッグ ヒープ マネージャーによって割り当てられたメモリを検証します。 基になるベース ヒープ、デバッグ ヘッダー情報、または上書きバッファーでエラーやメモリの不整合が検出された場合、_CrtCheckMemory はエラー状況を説明する情報を含むデバッグ レポートを生成します。 _DEBUG が定義されていない場合、_CrtCheckMemory の呼び出しは前処理で削除されます。
_CrtCheckMemoryの動作は、_CrtSetDbgFlag関数を使用して_crtDbgFlag フラグのビット フィールドを設定することで制御できます。 _CRTDBG_CHECK_ALWAYS_DF ビット フィールドを ON にすると、メモリ割り当て操作が要求されるたびに_CrtCheckMemoryが呼び出されます。 このメソッドでは実行速度が低下しますが、エラーをすばやくキャッチする場合に便利です。 _CRTDBG_ALLOC_MEM_DF ビット フィールドをオフにすると、_CrtCheckMemoryはヒープを検証せず、すぐにTRUEを返します。
この関数は TRUE または FALSEを返すので、 _ASSERT マクロのいずれかに渡して、基本的なデバッグ エラー処理メカニズムを作成できます。 次の例は、ヒープの破損が検出された場合に、アサーション エラーを発生させます。
_ASSERTE( _CrtCheckMemory( ) );
_CrtCheckMemoryを他のデバッグ関数と共に使用する方法の詳細については、「Heap 状態レポート関数を参照してください。 メモリ管理とデバッグ ヒープの概要については、「 CRT デバッグ ヒープの詳細を参照してください。
要件
| ルーチンによって返される値 | 必須ヘッダー |
|---|---|
_CrtCheckMemory |
<crtdbg.h> |
互換性の詳細については、「 Compatibility」を参照してください。
ライブラリ
C ランタイム ライブラリのデバッグ バージョンのみ。
例
_CrtCheckMemory の使用方法のサンプルについては、「crt_dbg1」を参照してください。