_aligned_offset_recalloc_dbg

變更使用 _aligned_malloc 或 _aligned_offset_malloc 配置的記憶體區塊大小，並將記憶體初始化為 0（僅限偵錯版本）。

語法

void * _aligned_offset_recalloc_dbg(
   void *memblock,
   size_t num,
   size_t size,
   size_t alignment,
   size_t offset,
   const char *filename,
   int linenumber
);

參數

memblock
目前記憶體區塊指標。

number
項目數。

size
每個項目的長度 (位元組)。

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

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

filename
要求重新配置作業或 NULL之原始程式檔名稱的指標。

linenumber
要求 realloc 作業的來源檔案中的行號或 NULL。

傳回值

_aligned_offset_recalloc_dbg 會傳回重新配置後 (且可能有移動) 記憶體區塊的 Void 指標。 如果大小為零且緩衝區自變數不是 NULL，或沒有足夠的可用記憶體將區塊擴充為指定的大小，則傳回值NULL為 。 在第一種情況中，會釋放原始區塊。 在第二種情況中，原始區塊會保留不變。 傳回值會指向適合儲存任何類型的物件的儲存空間。 若要取得 void 以外之類型的指標，請對傳回值使用類型轉換。

備註

_aligned_offset_realloc_dbg 是函式 _aligned_offset_recalloc 的偵錯版本。 未定義 時 _DEBUG ，對的每個呼叫 _aligned_offset_recalloc_dbg 都會縮減為 對 _aligned_offset_recalloc的呼叫。 並_aligned_offset_recalloc_aligned_offset_recalloc_dbg重新配置基底堆積中的記憶體區塊，但_aligned_offset_recalloc_dbg容納數個偵錯功能：區塊使用者部分任一端的緩衝區，以測試洩漏，以及/linenumberfilename決定配置要求來源的資訊。 使用區塊類型參數追蹤特定配置類型不是對齊配置支援的偵錯功能。 對齊的配置會顯示為 _NORMAL_BLOCK 區塊類型。

_aligned_offset_realloc_dbg 會使用比要求的 newSize 稍多一些的空間重新配置指定的記憶體區塊。 newSize 可能會比原始配置的記憶體區塊大小更多或更少。 偵錯堆積管理員會使用額外的空間來連結偵錯記憶體區塊，並提供偵錯標頭資訊和覆寫緩衝區的應用程式。 重新配置可能會將原始記憶體區塊移至堆積中的不同位置，也會變更記憶體區塊的大小。 若記憶體區塊已移動，則會覆寫原始區塊的內容。

若記憶體配置失敗，或是要求的大小 (number * size) 大於 _HEAP_MAXREQ，則此函式會將 errno 設為 ENOMEM。 如需 的詳細資訊errno，請參閱errno、 _doserrno_sys_errlist和 _sys_nerr。 此外，_aligned_offset_recalloc_dbg 也會驗證其參數。 如果 alignment 不是 2 的電源，或者 offset 如果 不是零且大於或等於要求的 size，則此函式會叫用無效的參數處理程式，如參數驗證中所述。 若允許繼續執行，此函式會傳回 NULL，並將 errno 設為 EINVAL。

如需如何在基底堆積偵錯版本中配置、初始化及管理記憶體區塊的相關信息，請參閱 CRT 偵錯堆積詳細數據。 如需配置區塊類型及其使用方式的相關信息，請參閱 偵錯堆積上的區塊類型。 如需標準堆積函式與其偵錯版本差異的相關信息，請參閱 堆積配置函式的偵錯版本。

需求

另請參閱

數據對齊方式