_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 執行階段程式庫。

另請參閱

偵錯常式