次の方法で共有


_aligned_offset_malloc_dbg

指定された配置境界 (デバッグ バージョンだけ) にメモリを割り当てます。

void * _aligned_offset_malloc_dbg(
   size_t size, 
   size_t alignment, 
   size_t offset,
   const char *filename,
   int linenumber 
);

パラメーター

  • [入力] size
    要求されたメモリ割り当てのサイズ。

  • [入力] alignment
    2. の整数乗する必要がある配置の値。

  • [入力] offset
    配置を設定するメモリ割り当てのオフセット。

  • [入力] filename
    要求されたソース ファイル名へのポインター操作または NULL。

  • [入力] linenumber
    割り当ての操作が要求または空白のソース ファイルの行番号。

戻り値

操作が失敗した場合または NULL 割り当てられたメモリ ブロックへのポインター。

解説

_aligned_offset_malloc_dbg は _aligned_offset_malloc の関数のデバッグ バージョンです。_DEBUG を定義しない場合_aligned_offset_malloc_dbg を呼び出すたびに_aligned_offset_malloc の呼び出しに減少します。_aligned_offset_malloc と _aligned_offset_malloc_dbg はベース ヒープ メモリ ブロックを _aligned_offset_malloc_dbg には一部のデバッグ機能が : 調べ割り当て要求の原点を確認するために特定の割り当て型を追跡するブロック型パラメーターと filename と linenumber 情報のテスト対象ブロックのユーザー領域の前後に確保されるバッファー。

_aligned_offset_malloc_dbg は要求された size よりもより多くの領域を使用してメモリ ブロックを割り当てます。デバッグ ヒープ マネージャーによって追加空間がデバッグ メモリ ブロックをリンクするとアプリケーションのデバッグのヘッダー情報とバッファーをオーバーライドするために使用されます。ブロックを割り当てるとブロックのユーザー領域は 0xCD 値を格納しておりオーバーライドのバッファーには 0xFD が格納されます。

_aligned_offset_malloc_dbg は配置に入れ子要素で必要な状況に適しています ; たとえば配置が入れ子になったクラスでは。

_aligned_offset_malloc_dbgmalloc に基づいています ; 詳細についてはmalloc を参照してください。

メモリ割り当てに失敗したり要求が _HEAP_MAXREQ サイズよりも大きい場合は関数のセット errnoENOMEMこの。errno の詳細については、「errno、_doserrno、_sys_errlist、および _sys_nerr」を参照してください。また**_aligned_offset_malloc** はパラメーターを検証します。alignment が 2 の累乗でないかoffset が size 以上でまたはゼロ以外の場合この関数は パラメーターの検証 に説明されているように無効なパラメーター ハンドラーを呼び出します。実行の継続が許可された場合、この関数は NULL を返し、errno を EINVAL に設定します。

デバッグ バージョンのベース ヒープに対するメモリ ブロックの割り当て、初期化、管理方法の詳細については、「メモリ管理とデバッグ ヒープ」を参照してください。

割り当てブロックの型についてはそれらがどのように使用されるかについてはデバッグ ヒープ ブロックの型 を参照してください。

必要条件

ルーチン

必須ヘッダー

_aligned_offset_malloc_dbg

<crtdbg.h>

互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。

ライブラリ

C ランタイム ライブラリのデバッグ バージョンのみ。

同等の .NET Framework 関数

該当なし標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。

参照

関連項目

デバッグ ルーチン