_aligned_msize

  • [アーティクル]

ヒープで割り当てられたメモリ ブロックのサイズを返します。

構文

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

パラメーター

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

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

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

戻り値

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

解説

この関数は_aligned_msize、呼_aligned_reallocび出しによって割り当てられたメモリ ブロックのサイズ (バイト単位) を_aligned_malloc返します。 alignment と offset の値は、ブロックを割り当てた関数に渡される値と同じである必要があります。

アプリケーションが C のランタイム ライブラリのデバッグ バージョンにリンクされている場合、_aligned_msize は _aligned_msize_dbg として解決されます。 デバッグ プロセス中のヒープの管理方法の詳細については、「CRT デバッグ ヒープ」を参照してください。

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

既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT のグローバル状態」を参照してください。

必要条件

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

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

ライブラリ

C ランタイム ライブラリのすべてのバージョン。

関連項目

メモリ割り当て