_aligned_recalloc_dbg
變更使用 _aligned_malloc
或 _aligned_offset_malloc
配置的記憶體區塊大小,並將記憶體初始化為 0(僅限偵錯版本)。
語法
void * _aligned_recalloc_dbg(
void * memblock,
size_t num,
size_t size,
size_t alignment,
const char *filename,
int linenumber
);
參數
memblock
目前記憶體區塊指標。
number
項目的數目。
size
每個項目的大小 (位元組)。
alignment
對齊值,必須是 2 的整數冪。
filename
要求配置作業之原始程式檔的名稱的指標,或為 NULL
。
linenumber
原始程式檔中的行號,其中要求配置作業,或為 NULL
。
傳回值
_aligned_recalloc_dbg
會傳回重新配置後 (且可能有移動) 記憶體區塊的 void
指標。 如果大小為零且緩衝區自變數不是 NULL
,或沒有足夠的可用記憶體將區塊擴充為指定的大小,則傳回值NULL
為 。 在第一種情況中,會釋放原始區塊。 在第二種情況中,原始區塊會保留不變。 傳回值會指向適合儲存任何類型的物件的儲存空間。 若要取得 void
以外之類型的指標,請對傳回值使用類型轉換。
重新配置記憶體並變更區塊的對齊方式時發生錯誤。
備註
_aligned_recalloc_dbg
是函式 _aligned_recalloc
的偵錯版本。 未定義 時 _DEBUG
,對的每個呼叫 _aligned_recalloc_dbg
都會縮減為 對 _aligned_recalloc
的呼叫。 並_aligned_recalloc
_aligned_recalloc_dbg
重新配置基底堆積中的記憶體區塊,但_aligned_recalloc_dbg
容納數個偵錯功能:區塊使用者部分任一端的緩衝區,以測試洩漏,以及/linenumber
filename
決定配置要求來源的資訊。 使用區塊類型參數追蹤特定配置類型不是對齊配置支援的偵錯功能。 對齊的配置會顯示為 _NORMAL_BLOCK
區塊類型。
_aligned_recalloc_dbg
會使用比要求的大小還要稍微多一些的空間重新配置指定的記憶體區塊 (number
* size
),而要求的大小可能會比原始配置的記憶體區塊大小更大或更小。 偵錯堆積管理員會使用額外的空間來連結偵錯記憶體區塊,並提供偵錯標頭資訊和覆寫緩衝區的應用程式。 重新配置可能會將原始記憶體區塊移至堆積中的不同位置,並變更記憶體區塊的大小。 區塊的使用者部分會填入值0xCD,而覆寫緩衝區會填入0xFD。
若記憶體配置失敗,_aligned_recalloc_dbg
會將 errno
設定為 ENOMEM
;若所需的記憶體數量 (包含之前提到的額外負荷) 超過 EINVAL
,則會傳回 _HEAP_MAXREQ
。 如您需要此錯誤碼和其他錯誤碼的相關資訊,請參閱errno
、 _doserrno
_sys_errlist
與 _sys_nerr
。
此外,_aligned_recalloc_dbg
也會驗證其參數。 如果 alignment
不是 2 的電源,此函式會叫用無效的參數處理程式,如參數驗證中所述。 若允許繼續執行,此函式會傳回 NULL
,並將 errno
設為 EINVAL
。
如需如何在基底堆積偵錯版本中配置、初始化及管理記憶體區塊的相關信息,請參閱 CRT 偵錯堆積詳細數據。 如需配置區塊類型及其使用方式的相關信息,請參閱 偵錯堆積上的區塊類型。 如需標準堆積函式與其偵錯版本差異的相關信息,請參閱 堆積配置函式的偵錯版本。
需求
常式 | 必要的標頭 |
---|---|
_aligned_recalloc_dbg |
<crtdbg.h> |
如需相容性詳細資訊,請參閱相容性。
程式庫
僅限偵錯版本的 C 執行階段程式庫。