Share via


_aligned_msize_dbg

傳回堆積中所配置的記憶體區塊大小 (僅限偵錯版本)。

語法

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

參數

memblock
記憶體區塊的指標。

alignment
對齊值,必須是 2 的整數冪。

offset
記憶體配置中要強制對齊的位移。

傳回值

傳回不帶正負號的整數大小 (以位元組為單位)。

備註

alignmentoffset 值必須與傳遞至配置區塊函式的值相同。

_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 偵錯堆積詳細資料 。 如需配置區塊類型及其使用方式的相關資訊,請參閱 偵錯堆積 上的區塊類型。 如需標準堆積函式與其偵錯版本差異的相關資訊,請參閱 堆積配置函 式的偵錯版本。

需求

常式 必要的標頭
_aligned_msize_dbg <crtdbg.h>

如需相容性詳細資訊,請參閱相容性

程式庫

僅限偵錯版本的 C 執行階段程式庫

另請參閱

記憶體配置