_aligned_realloc
Změní velikost bloku paměti, který byl přidělen _aligned_malloc _aligned_offset_mallocnebo .
Syntaxe
void * _aligned_realloc(
void *memblock,
size_t size,
size_t alignment
);
Parametry
memblock
Aktuální ukazatel bloku paměti.
size
Velikost požadovaného přidělení paměti.
alignment
Hodnota zarovnání, která musí být celočíselná mocnina 2.
Vrácená hodnota
_aligned_realloc vrátí ukazatel void na relokovaný (a pravděpodobně přesunutý) paměťový blok. Vrácená hodnota je NULL , pokud je velikost nula a argument vyrovnávací paměti není NULLnebo pokud není dostatek dostupné paměti k rozšíření bloku na danou velikost. V prvním případě se původní blok uvolní. Za druhé se původní blok nezmění. Návratová hodnota odkazuje na prostor úložiště, který je vhodně zarovnaný pro úložiště libovolného typu objektu. Pokud chcete získat ukazatel na jiný typ než void, použijte přetypování typu na návratovou hodnotu.
Jedná se o chybu při opětovném přidělení paměti a změně zarovnání bloku.
Poznámky
_aligned_realloc je založena na malloc. Další informace o použití _aligned_offset_mallocnaleznete v tématu malloc.
Tato funkce nastaví errno ENOMEM , jestli přidělení paměti selhalo nebo pokud byla požadovaná velikost větší než _HEAP_MAXREQ. Další informace o errno, vizerrno , _doserrno, _sys_errlist, a _sys_nerr. _aligned_realloc Ověří také jeho parametry. Pokud alignment není mocnina 2, tato funkce vyvolá neplatnou obslužnou rutinu parametru, jak je popsáno v ověření parametru. Pokud je spuštění povoleno pokračovat, tato funkce vrátí NULL a nastaví errno hodnotu EINVAL.
Ve výchozím nastavení je globální stav této funkce vymezen na aplikaci. Chcete-li toto chování změnit, přečtěte si téma Globální stav v CRT.
Požadavky
| Rutina | Požadovaný hlavičkový soubor |
|---|---|
_aligned_realloc |
<malloc.h> |
Příklad
Další informace najdete na webu _aligned_malloc.