ヒープに割り当てられたメモリ ブロックのサイズを返します。
size_t _msize(
void *memblock,
size_t alignment,
size_t offset
);
パラメーター
[入力] memblock
メモリ ブロックへのポインター。[入力] alignment
配置の値。2 の累乗値を指定する必要があります。[入力] offset
強制的にアラインメントするために割り当てるメモリのオフセット。
戻り値
サイズ (バイト数) を符号なし整数として返します。
解説
_aligned_msize 関数は、_aligned_malloc または _aligned_realloc の呼び出しによって割り当てられたメモリ ブロックのサイズをバイト数で返します。 alignment 値と offset 値は、ブロックを割り当てた関数に渡された値と同じであることが必要です。
アプリケーションが C ランタイム ライブラリのデバッグ バージョンとリンクされている場合、_aligned_msize は _aligned_msize_dbg として解決されます。 デバッグ中のヒープの処理方法の詳細については、「CRT デバッグ ヒープ」を参照してください。
この関数は、パラメーターを検証します。 memblock が null ポインター、または alignment が 2 の累乗でない場合、_msize は、「パラメーターの検証」に説明されているように、無効なパラメーター ハンドラーを呼び出します。 エラーが処理されると、この関数は errno を EINVAL に設定し、-1 を返します。
必要条件
ルーチン |
必須ヘッダー |
|---|---|
_msize |
<malloc.h> |
互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。
ライブラリ
C ランタイム ライブラリのすべてのバージョン。
同等の .NET Framework 関数
該当なし標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。