_aligned_recalloc
變更使用 _aligned_malloc
或 _aligned_offset_malloc
配置的記憶體區塊大小,並將記憶體初始化為 0。
語法
void * _aligned_recalloc(
void *memblock,
size_t num,
size_t size,
size_t alignment
);
參數
memblock
目前記憶體區塊指標。
number
項目的數目。
size
每個項目的大小 (位元組)。
alignment
對齊值,必須是 2 的整數冪。
傳回值
_aligned_recalloc
會傳回重新配置後 (且可能有移動) 記憶體區塊的 Void 指標。 如果大小為零且緩衝區自變數不是 NULL
,或沒有足夠的可用記憶體將區塊擴充為指定的大小,則傳回值NULL
為 。 在第一種情況中,會釋放原始區塊。 在第二種情況中,原始區塊會保留不變。 傳回值會指向適合儲存任何類型的物件的儲存空間。 若要取得 Void 類型以外的指標,請對傳回值使用類型轉換。
重新配置記憶體並變更區塊的對齊方式時發生錯誤。
備註
_aligned_recalloc
是以 malloc
為基礎。 如需有關使用 _aligned_offset_malloc
的詳細資訊,請參閱malloc
。
若記憶體配置失敗,或是要求的大小大於 errno
,則此函式會將 ENOMEM
設為 _HEAP_MAXREQ
。 如需 的詳細資訊errno
,請參閱errno
、 _doserrno
_sys_errlist
和 _sys_nerr
。 此外,_aligned_recalloc
也會驗證其參數。 如果 alignment
不是 2 的電源,此函式會叫用無效的參數處理程式,如參數驗證中所述。 若允許繼續執行,此函式會傳回 NULL
,並將 errno
設為 EINVAL
。
根據預設,此函式的全域狀態會限定於應用程式。 若要變更此行為,請參閱 CRT 中的全域狀態。
需求
常式 | 必要的標頭 |
---|---|
_aligned_recalloc |
<malloc.h> |