_aligned_offset_realloc_dbg

Změní velikost bloku paměti, který byl přidělen _aligned_malloc nebo _aligned_offset_malloc (pouze ladicí verze).

Syntaxe

void * _aligned_offset_realloc_dbg(
   void *memblock,
   size_t size,
   size_t alignment,
   size_t offset,
   const char *filename,
   int linenumber
);

Parametry

memblock
Aktuální ukazatel bloku paměti.

size
Velikost přidělení paměti.

alignment
Hodnota zarovnání, která musí být celočíselná mocnina 2.

offset
Posun do přidělení paměti k vynucení zarovnání.

filename
Ukazatel na název zdrojového souboru, který požadoval aligned_offset_realloc operaci nebo NULL.

linenumber
Číslo řádku ve zdrojovém souboru, kde aligned_offset_realloc byla operace požadována nebo NULL.

Vrácená hodnota

_aligned_offset_realloc_dbg 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í. V druhém případě 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.

Poznámky

_aligned_offset_realloc_dbg je ladicí verze _aligned_offset_realloc funkce. Pokud _DEBUG není definováno, každé volání _aligned_offset_realloc_dbg se sníží na volání _aligned_offset_realloc. Blok _aligned_offset_realloc paměti v základní haldě a _aligned_offset_realloc_dbg relokujte ho, ale _aligned_offset_realloc_dbg zahrnuje několik funkcí ladění: vyrovnávací paměti na obou stranách bloku, které se mají otestovat na nevracení, a filename/linenumber informace pro určení původu žádostí o přidělení. Sledování konkrétních typů přidělení pomocí parametru typu bloku není podporovanou funkcí ladění pro sladěné přidělení. Zarovnané přidělení se zobrazí jako _NORMAL_BLOCK typ bloku.

Podobně jako _aligned_offset_mallocumožňuje _aligned_offset_realloc_dbg , aby byla struktura zarovnaná na odsazení v rámci struktury.

_realloc_dbg přeloží zadaný blok paměti o trochu více místa, než je požadováno newSize. newSize může být větší nebo menší než velikost původně přiděleného bloku paměti. Další místo používá správce haldy ladění k propojení bloků paměti ladění a k poskytnutí aplikace informace hlavičky ladění a přepsání vyrovnávací paměti. Reálná poloha může přesunout původní blok paměti do jiného umístění v haldě a také změnit velikost bloku paměti. Pokud se blok paměti přesune, obsah původního bloku se přepíše.

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_offset_realloc_dbg Ověří také jeho parametry. Pokud alignment není mocnina 2 nebo pokud offset je nenulová a větší nebo rovna size, 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.

Informace o přidělování, inicializaci a správě bloků paměti ve verzi ladění základní haldy naleznete v podrobnostech haldy ladění CRT. Informace o typech bloků přidělení a jejich použití najdete v tématu Typy bloků v haldě ladění. Informace o rozdílech mezi standardními funkcemi haldy a jejich ladicí verze naleznete v tématu Ladění verzí funkcí přidělení haldy.

Požadavky

Další informace o kompatibilitě najdete v tématu Kompatibilita.

Knihovny

Ladění pouze verzí knihoven runtime jazyka C.

Viz také

Rutiny ladění