_free_dbg
ヒープ内のメモリ ブロックを解放します (デバッグ バージョンのみ)。
void _free_dbg(
void *userData,
int blockType
);
パラメーター
userData
解放される、割り当てられていたメモリ ブロックへのポインター。blockType
解放される、割り当てられていたメモリ ブロックの型。_CLIENT_BLOCK、_NORMAL_BLOCK、または _IGNORE_BLOCK。
解説
_free_dbg 関数は、free 関数のデバッグ バージョンです。 _DEBUG が定義されない場合、_free_dbg への各呼び出しは free への呼び出しになります。 free と _free_dbg は、どちらもベース ヒープのメモリ ブロックを解放しますが、_free_dbg は 2 つのデバッグ機能を提供します。解放されたブロックをヒープのリンク リストに保持してメモリ不足の状況をシミュレートする機能と、特定の種類の割り当てを解放するためのブロック型パラメーターです。
_free_dbg は、解放操作を実行する前に、指定されたすべてのファイルおよびブロックの位置の有効性チェックを実行します。 アプリケーションは、この情報を提供する必要はありません。 メモリ ブロックが解放されると、デバッグ ヒープ マネージャーはユーザー部分の前後のバッファーの整合性を自動的にチェックし、それらのバッファーが上書きされていた場合はエラー レポートを発行します。 _crtDbgFlag フラグの _CRTDBG_DELAY_FREE_MEM_DF ビット フィールドが設定されている場合、解放されたブロックは値 0xDD 値を設定され、_FREE_BLOCK ブロック型を割り当てられ、ヒープのメモリ ブロックのリンク リストに保持されます。
メモリの解放でエラーが発生すると、エラーの性質に関するオペレーティング システムからの情報が errno に設定されます。 詳細については、「errno、_doserrno、_sys_errlist、および _sys_nerr」を参照してください。
デバッグ バージョンのベース ヒープに対するメモリ ブロックの割り当て、初期化、管理方法の詳細については、「CRT デバッグ ヒープ」を参照してください。 割り当てブロック型と、それらがどのように使用されるかについては、「デバッグ ヒープ上のメモリ ブロックの型」を参照してください。 アプリケーションのデバッグ ビルドで標準ヒープ関数を呼び出す場合とデバッグ バージョンを呼び出す場合との違いについては、「デバッグ バージョンのヒープ割り当て関数」を参照してください。
必要条件
ルーチン |
必須ヘッダー |
|---|---|
_free_dbg |
<crtdbg.h> |
互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。
使用例
_free_dbg の使用例については、「crt_dbg2」を参照してください。
同等の .NET Framework 関数
使用できません。標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。