共用方式為


_aligned_offset_realloc

變更 _aligned_malloc_aligned_offset_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_reallocmalloc為基礎。 如需有關使用 _aligned_offset_malloc 的詳細資訊,請參閱malloc。 如果 memblock 是 NULL,函式內部呼叫 _aligned_offset_malloc 。

如果記憶體配置失敗或者要求大小大於 _HEAP_MAXREQ,這個函式會將 errno 設為 ENOMEM。 如需 errno 的詳細資訊,請參閱 errno、_doserrno、_sys_errlist 和 _sys_nerr。 此外, _aligned_offset_realloc 會驗證其參數。 如果 alignment 不是 2 的次方,或 offset 大於或等於 size 並且不是零,這個函式會叫用無效參數處理常式,如 參數驗證中所述。 如果允許繼續執行,這個函式會傳回 NULL,並將 errno 設為 EINVAL。

需求

常式

必要的標頭

_aligned_offset_realloc

<malloc.h>

範例

如需詳細資訊,請參閱 _aligned_malloc

請參閱

參考

資料對齊