共用方式為


_aligned_offset_realloc

變更使用 或_aligned_offset_malloc配置的_aligned_malloc記憶體區塊大小。

語法

void * _aligned_offset_realloc(
   void *memblock,
   size_t size,
   size_t alignment,
   size_t offset
);

參數

memblock
目前記憶體區塊指標。

size
記憶體配置的大小。

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

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

傳回值

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

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

備註

如同 _aligned_offset_malloc_aligned_offset_realloc 允許結構對齊結構內的位移。

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

若記憶體配置失敗,或是要求的大小大於 errno,則此函式會將 ENOMEM 設為 _HEAP_MAXREQ。 如需 的詳細資訊errno,請參閱errno_doserrno_sys_errlist_sys_nerr。 此外,_aligned_offset_realloc 也會驗證其參數。 如果 alignment 不是 2 的電源,或如果 offset 不是零且大於或等於 size,則此函式會叫用無效的參數處理程式,如參數驗證中所述。 若允許繼續執行,此函式會傳回 NULL,並將 errno 設為 EINVAL

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

需求

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

範例

如需詳細資訊,請參閱_aligned_malloc

另請參閱

數據對齊方式