_aligned_msize_dbg

  • [アーティクル]

ヒープで割り当てられたメモリ ブロックのサイズを返します (デバッグ バージョンのみ)。

構文

size_t _aligned_msize_dbg(
   void *memblock,
   size_t alignment,
   size_t offset
);

パラメーター

memblock
メモリ ブロックへのポインター。

alignment
アラインメント値。2 の整数乗である必要があります。

offset
アラインメントを強制するためのメモリ割り当てへのオフセット。

戻り値

符号なし整数としてサイズ (バイト数) を返します。

解説

alignment と offset の値は、ブロックを割り当てた関数に渡される値と同じである必要があります。

_aligned_msize_dbg は関数の _aligned_msize デバッグ バージョンです。 定義されていない場合 _DEBUG 、各呼び出しは次の呼び _aligned_msize_dbg 出し _aligned_msizeに減らされます。 _aligned_msize と _aligned_msize_dbg は、どちらもベース ヒープ内のメモリ ブロックのサイズを計算しますが、_aligned_msize_dbg はデバッグ機能を追加します。そのため、返されるサイズに、メモリ ブロックのユーザー部分の両側のバッファーが含められます。

この関数は、そのパラメーターを検証します。 null ポインターの場合、または alignment 2 の累乗でない場合memblockは、「_msizeパラメーターの検証」で説明されているように、無効なパラメーター ハンドラーを呼び出します。 エラーが処理されると、errno が EINVAL に設定され、-1 が返されます。

基本ヒープのデバッグ バージョンでのメモリ ブロックの割り当て、初期化、および管理方法については、CRT デバッグ ヒープの詳細を参照してください。 割り当てブロックの種類とその使用方法については、「デバッグ ヒープ上のブロックの種類」を参照してください。 標準ヒープ関数とそのデバッグ バージョンの違いについては、ヒープ割り当て関数のデバッグ バージョンを参照してください。

必要条件

ルーチンによって返される値 必須ヘッダー
_aligned_msize_dbg <crtdbg.h>

互換性の詳細については、「 Compatibility」を参照してください。

ライブラリ

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

関連項目

メモリ割り当て