_aligned_offset_realloc_dbg
Ändert die Größe eines Speicherblocks, der mit _aligned_malloc oder _aligned_offset_malloc belegt ist (nur in der Debugversion).
void * _aligned_offset_realloc_dbg( void *memblock, size_t size, size_t alignment, size_t offset, const char *filename, int linenumber );
Parameter
[in] memblock
Der Zeiger auf den aktuellen Speicherblock.[in] size
Die Größe der Speicherbelegung.[in] alignment
Der Ausrichtungswert, der eine ganzzahlige Potenz von 2 sein muss.[in] offset
Der Offset in der Speicherbelegung zum Erzwingen der Ausrichtung.[in] filename
Zeiger zum Namen der Quelldatei, der den aligned_offset_realloc-Vorgang angefordert hat, oder NULL.[in] linenumber
Zeilennummer in der Quelldatei, in der der aligned_offset_realloc-Vorgang angefordert wurde, oder NULL.
Rückgabewert
_aligned_offset_realloc_dbg gibt einen leeren Zeiger auf den neu belegten (und möglicherweise verschobenen) Speicherblock zurück. Der Rückgabewert ist NULL, wenn die Größe 0 ist und das Pufferargument nicht NULL ist oder wenn nicht genügend Speicherplatz vorhanden ist, um den Block auf die vorgegebene Größe auszudehnen. Im ersten Fall wird der ursprüngliche Block freigegeben. Im zweiten Fall wird der ursprüngliche Block nicht geändert. Der Rückgabewert zeigt auf einen Speicherplatz, der für die Speicherung eines beliebigen Objekttyps geeignet ist. Um einen Zeiger auf einen anderen Typ als den leeren zurückzugeben, verwenden Sie eine Typumwandlung für den Rückgabewert.
Hinweise
_aligned_offset_realloc_dbg ist eine Debugversion der _aligned_offset_realloc-Funktion. Wenn _DEBUG nicht definiert ist, wird jeder Aufruf von _aligned_offset_realloc_dbg zu einem Aufruf von aligned_offset_realloc reduziert. Sowohl aligned_offset_realloc als auch _aligned_offset_realloc_dbg belegen einen Speicherblock im Basisheap neu, jedoch verfügt _aligned_offset_realloc_dbg über mehrere Debugfunktionen: Puffer auf beiden Seiten des Benutzerteils des Blocks zum Prüfen auf Speicherverluste, einen Blocktypparameter zum Nachverfolgen bestimmter Belegungstypen und filename/linenumber-Informationen zum Ermitteln des Ursprungs von Belegungsanforderungen.
Genau wie _aligned_offset_malloc erlaubt _aligned_offset_realloc_dbg die Ausrichtung einer Struktur an einem Offset innerhalb der Struktur.
_realloc_dbg belegt den angegebenen Speicherblock neu mit etwas mehr Speicherplatz als der angeforderten newSize. newSize kann größer oder kleiner sein als die Größe des ursprünglich belegten Speicherblocks. Der zusätzliche Speicherplatz wird vom Debugheapmanager verwendet, um die Debugspeicherblöck zu verknüpfen und Debugheaderinformationen und Überschreibungspuffer für die Anwendung bereitzustellen. Durch die Neubelegung wird der ursprüngliche Speicherblock möglicherweise an einen anderen Speicherort im Heap verschoben und auch die Größe des Speicherblocks geändert. Wenn der Speicherblock verschoben wird, wird der Inhalt des ursprünglichen Blocks überschrieben.
Diese Funktion legt errno auf ENOMEM fest, wenn die Speicherbelegung fehlgeschlagen ist oder die angeforderte Größe größer als _HEAP_MAXREQ war. Weitere Informationen zu errno finden Sie unter errno, _doserrno, _sys_errlist und _sys_nerr. Darüber hinaus überprüft _aligned_offset_realloc_dbg auch die eigenen Parameter. Wenn alignment keine Potenz von 2 ist oder offset größer als oder gleich size und ungleich 0 ist, ruft diese Funktion den ungültigen Parameterhandler auf, wie in Parametervalidierung beschrieben. Wenn die weitere Ausführung zugelassen wird, gibt diese Funktion NULL zurück und stellt errno auf NULL ein.
Informationen darüber, wie Speicherblöcke in der Debugversion des Basisheaps zugeordnet, initialisiert und verwaltet werden, finden Sie unter Details zum CRT-Debugheap. Weitere Informationen zu den Zuordnungsblocktypen und ihrer Verwendung finden Sie unter Blocktypen auf dem Debugheap. Weitere Informationen zu den Unterschieden zwischen dem Aufruf einer Standardheapfunktion und der Debugversion in einem Debugbuild einer Anwendung finden Sie unter Debugversionen von Heapreservierungsfunktionen.
Anforderungen
Routine |
Erforderlicher Header |
|---|---|
_aligned_offset_realloc_dbg |
<crtdbg.h> |
Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität in der Einführung.
Bibliotheken
Nur Debugversionen von C-Laufzeitbibliotheken.
.NET Framework-Entsprechung
Nicht zutreffend. Mit PInvoke rufen Sie die Standard-C-Funktion auf. Weitere Informationen finden Sie unter Beispiele für Plattformaufrufe.