_aligned_msize

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

構文

size_t _aligned_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 の累乗でない場合、_aligned_msizeは無効なパラメーター ハンドラーを呼び出します(パラメーター検証。 エラーが処理されると、errno が EINVAL に設定され、-1 が返されます。

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

要件

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

ライブラリ

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

関連項目

メモリ割り当て