_aligned_realloc_dbg
變更使用 _aligned_malloc 或 _aligned_offset_malloc 所配置的記憶體區塊大小 (僅限偵錯版本)。
void * _aligned_realloc_dbg( void *memblock, size_t size, size_t alignment, const char *filename, int linenumber );
參數
[in] memblock
目前記憶體區塊指標。[in] size
要求的記憶體配置的大小。[in] alignment
對齊值，必須是 2 的整數冪。[in] filename
要求 realloc 作業之原始程式檔的名稱的指標，或為 NULL。[in] linenumber
原始程式檔中的行號，其中要求 realloc 作業，或為 NULL。
傳回值
_aligned_realloc_dbg 會傳回重新配置後 (且可能有移動) 記憶體區塊的 Void 指標。 若大小為 0，且緩衝區引數不是 NULL，則傳回值為 NULL，或者，若沒有足夠的可用記憶體將區塊展開為指定大小，傳回值也會是 NULL。 在第一種情況中，會釋放原始區塊。 在第二種情況中，原始區塊會保留不變。 儲存空間的傳回值指標，是能夠適當地對齊任何物件類型之儲存區的保證。 若要取得 Void 類型以外的指標，請對傳回值使用類型轉換。
重新配置記憶體並變更區塊的對齊是不對的。
備註
_aligned_realloc_dbg 是偵錯版本的 _aligned_realloc 函式。 當 _DEBUG 未定義時，每個 _aligned_realloc_dbg 的呼叫會降至 _aligned_realloc 的呼叫。 _aligned_realloc和 _aligned_realloc_dbg 都會重新配置基底堆積中的記憶體區塊，但 _aligned_realloc_dbg 還容納數種偵錯功能：在區塊的使用者部分的任一端使用緩衝區以測試遺漏，以及追蹤特定配置類型的區塊類型參數，還有判斷配置要求來源的 filename/linenumber 資訊。
_aligned_realloc_dbg 會使用比要求的 newSize 稍多一些的空間重新配置指定的記憶體區塊。 newSize 可能會比原始配置的記憶體區塊大小更多或更少。 偵錯堆積管理員會使用額外的空間連結偵錯記憶體區塊，以及為應用程式提供偵錯標頭資訊和覆寫緩衝區。 重新配置可能會導致將原始記憶體區塊移到堆積中的不同位置，也可能會變更記憶體區塊的大小。 若記憶體區塊已移動，則會覆寫原始區塊的內容。
若記憶體配置失敗，或是所需的記憶體數量 (包含之前提到的額外負荷) 超過 _HEAP_MAXREQ，_aligned_realloc_dbg 會將 errno 設定為 ENOMEM。 如需此錯誤碼及其他錯誤碼的詳細資訊，請參閱 errno、_doserrno、_sys_errlist 和 _sys_nerr。
此外，_aligned_realloc_dbg 也會驗證其參數。 若 alignment 不是 2 的冪，則此函式會叫用無效參數處理常式，如 參數驗證 中所述。 若允許繼續執行，此函式會傳回 NULL，並將 errno 設為 EINVAL。
如需在偵錯版本的基底堆積中如何配置、初始化及管理記憶體區塊的資訊，請參閱 CRT 偵錯堆積詳細資料。 如需配置區塊類型以及如何使用它們的詳細資訊，請參閱 偵錯堆積上的區塊類型。 如需在應用程式的偵錯組建中呼叫標準堆積函式以及其偵錯版本之間的差異的資訊，請參閱 堆積配置函式的偵錯版本。
需求
常式 |
必要的標頭 |
|---|---|
_aligned_realloc_dbg |
<crtdbg.h> |
如需相容性詳細資訊，請參閱＜簡介＞中的相容性。
程式庫
偵錯版本的 C 執行階段程式庫。
.NET Framework 對等用法
不適用。若要呼叫標準 C 函式，請使用 PInvoke。如需詳細資訊，請參閱平台叫用範例。