_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 はデバッグ機能を追加します。そのため、返されるサイズに、メモリ ブロックのユーザー部分の両側のバッファーが含められます。
この関数は、そのパラメーターを検証します。 memblockが null ポインターであるか、alignmentが 2 の累乗でない場合、_msizeは無効なパラメーター ハンドラーを呼び出します(パラメーター検証。 エラーが処理されると、errno が EINVAL に設定され、-1 が返されます。
基本ヒープのデバッグ バージョンでのメモリ ブロックの割り当て、初期化、および管理方法については、「 CRT デバッグ ヒープの詳細を参照してください。 割り当てブロックの種類とその使用方法については、「デバッグ ヒープ上のブロックの種類を参照してください。 標準ヒープ関数とそのデバッグ バージョンの違いについては、「 Debug バージョンのヒープ割り当て関数を参照してください。
要件
| ルーチンによって返される値 | 必須ヘッダー |
|---|---|
_aligned_msize_dbg |
<crtdbg.h> |
互換性の詳細については、「 Compatibility」を参照してください。
ライブラリ
C ランタイム ライブラリのデバッグ バージョンのみ。