_aligned_offset_recalloc

變更使用 _aligned_malloc 或 _aligned_offset_malloc 配置的記憶體區塊大小，並將記憶體初始化為 0。

語法

void * _aligned_offset_recalloc(
   void *memblock,
   size_t num,
   size_t size,
   size_t alignment,
   size_t offset
);

參數

memblock
目前記憶體區塊指標。

number
項目數。

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

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

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

傳回值

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

_aligned_offset_recalloc 標示 __declspec(noalias) 為 和 __declspec(restrict) ，這表示函式保證不會修改全域變數，且傳回的指標不會有別名。 如需詳細資訊，請參閱 noalias 和 restrict。

備註

如同 _aligned_offset_malloc ， _aligned_offset_recalloc 允許結構對齊結構內的位移。

_aligned_offset_recalloc 是以 malloc 為基礎。 如需有關使用 _aligned_offset_malloc 的詳細資訊，請參閱malloc。 如果 memblock 是 NULL，則函式會在內部呼叫 _aligned_offset_malloc。

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

根據預設，此函式的全域狀態會限定于應用程式。 若要變更此行為，請參閱 CRT 中的全域狀態。

需求

常式	必要的標頭
_aligned_offset_recalloc	<malloc.h>

另請參閱

資料對齊方式
_recalloc
_aligned_recalloc