_aligned_offset_recalloc_dbg

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

Syntaxe

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

Parametry

memblock
Aktuální ukazatel bloku paměti.

number
Počet prvků

size
Délka v bajtech každého prvku

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 operaci skutečného přidělení nebo NULL.

linenumber
Číslo řádku ve zdrojovém souboru, kde byla operace skutečného přidělení požadována nebo NULL.

Vrácená hodnota

_aligned_offset_recalloc_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_recalloc funkce. Pokud _DEBUG není definováno, každé volání _aligned_offset_recalloc_dbg se sníží na volání _aligned_offset_recalloc. Blok _aligned_offset_recalloc paměti v základní haldě a _aligned_offset_recalloc_dbg relokujte ho, ale _aligned_offset_recalloc_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.

_aligned_offset_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 ( * numbersize) větší než _HEAP_MAXREQ. Další informace o errno, vizerrno , _doserrno, _sys_errlist, a _sys_nerr. _aligned_offset_recalloc_dbg Ověří také jeho parametry. Pokud alignment není mocnina 2 nebo pokud offset není nulová a větší nebo rovna sizepožadovanému, vyvolá tato funkce 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

Viz také

Zarovnání dat