_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 指標。 傳回值是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可能是大於或小於原本已配置的記憶體區塊的大小。 額外的空間用於偵錯堆積管理員若要連結的偵錯記憶體區塊,並提供偵錯標頭資訊給應用程式,並覆寫緩衝區。 重新配置可能會導致將原始的記憶體區塊移至堆積中,在不同的位置,以及變更記憶體區塊的大小而定。 如果移動記憶體區塊時,會覆寫原始區塊的內容。
_aligned_realloc_dbg設定errno到ENOMEM記憶體配置失敗時,或所需的記憶體 (包括先前所述的額外負荷) 量超過_HEAP_MAXREQ。 如需這和其他錯誤碼資訊,請參閱errno、 _doserrno、 _sys_errlist 和 _sys_nerr。
此外, _aligned_realloc_dbg驗證它的參數。 如果alignment並不是可使用的冪為 2,此函式呼叫不正確的參數處理常式中,如所述參數驗證。 如果執行則允許繼續執行,則這個函式會傳回NULL ,並設定errno到EINVAL。
如需有關如何記憶體區塊會配置、 初始化,而且在基底堆積的偵錯版本管理的資訊,請參閱記憶體管理和偵錯堆積。 配置的區塊型別和它們的使用方式的相關資訊,請參閱類型的區塊在偵錯堆積上。 呼叫 [應用程式的偵錯組建中的 [標準的堆積函式和它的偵錯版本之間的差異的相關資訊,請參閱使用偵錯版本 Versus 基底版本。
需求
常式 |
所需的標頭 |
---|---|
_aligned_realloc_dbg |
<crtdbg.h> |
如需相容性資訊,請參閱相容性在簡介中。
文件庫
偵錯版本的 C 執行階段程式庫只。
.NET Framework 對等用法
不適用。 若要呼叫標準的 c 函式,使用PInvoke。 如需詳細資訊,請參閱平台叫用範例。