_aligned_offset_malloc_dbg
在指定的對齊界限上配置記憶體 (僅限偵錯版本)。
語法
void * _aligned_offset_malloc_dbg(
size_t size,
size_t alignment,
size_t offset,
const char *filename,
int linenumber
);
參數
size
要求的記憶體配置的大小。
alignment
對齊值,必須是 2 的整數冪。
offset
記憶體配置中要強制對齊的位移。
filename
要求配置作業之原始程式檔的名稱的指標,或為 NULL
。
linenumber
原始程式檔中的行號,其中要求配置作業,或為 NULL
。
傳回值
已配置之記憶體區塊的指標,或為 NULL
(作業失敗時)。
備註
_aligned_offset_malloc_dbg
是函式 _aligned_offset_malloc
的偵錯版本。 未定義 時 _DEBUG
,對的每個呼叫 _aligned_offset_malloc_dbg
都會縮減為 對 _aligned_offset_malloc
的呼叫。 _aligned_offset_malloc
和 _aligned_offset_malloc_dbg
都會配置基底堆積中的記憶體區塊,但 _aligned_offset_malloc_dbg
還提供數種偵錯功能:在區塊的使用者部分的任一端使用緩衝區以測試遺漏,以及判斷配置要求來源的 filename
/linenumber
資訊。 使用區塊類型參數追蹤特定配置類型不是對齊配置支援的偵錯功能。 對齊的配置會顯示為 _NORMAL_BLOCK
區塊類型。
_aligned_offset_malloc_dbg
會使用比要求的 size
稍多一些的空間配置記憶體區塊。 偵錯堆積管理員會使用額外的空間來連結偵錯記憶體區塊,並提供偵錯標頭資訊和覆寫緩衝區的應用程式。 配置區塊時,區塊的使用者部分會填入值0xCD,而且每個覆寫緩衝區都會填入0xFD。
_aligned_offset_malloc_dbg
適用於巢狀元素需要對齊的情況,例如,如果巢狀類別需要對齊時。
_aligned_offset_malloc_dbg
是以 為基礎 malloc
,如需詳細資訊,請參閱 malloc
。
若記憶體配置失敗,或是要求的大小大於 errno
,則此函式會將 ENOMEM
設為 _HEAP_MAXREQ
。 如需 的詳細資訊errno
,請參閱errno
、 _doserrno
_sys_errlist
和 _sys_nerr
。 此外,_aligned_offset_malloc
也會驗證其參數。 如果 alignment
不是 2 的電源,或者offset
如果 不是零且大於或等於 size
,則此函式會叫用無效的參數處理程式,如參數驗證中所述。 若允許繼續執行,此函式會傳回 NULL
,並將 errno
設為 EINVAL
。
如需如何在基底堆積偵錯版本中配置、初始化及管理記憶體區塊的相關信息,請參閱 CRT 偵錯堆積詳細數據。
如需配置區塊類型及其使用方式的相關信息,請參閱 偵錯堆積上的區塊類型。
需求
常式 | 必要的標頭 |
---|---|
_aligned_offset_malloc_dbg |
<crtdbg.h> |
如需相容性詳細資訊,請參閱相容性。
程式庫
僅限偵錯版本的 C 執行階段程式庫。