_aligned_recalloc_dbg
Ändert die Größe eines Speicherblocks, der _aligned_malloc oder _aligned_offset_malloc zugeordnet wurde, und initialisiert den Arbeitsspeicher nur bis 0 (Debugversion).
void * _aligned_recalloc_dbg(
void * memblock,
size_t num,
size_t size,
size_t alignment,
const char *filename,
int linenumber
);
Parameter
[in] memblock
Der aktuelle Zeiger Speicherblock.[in] num
Die Anzahl der Elemente.[in] size
Die Größe in Byte) der einzelnen Elemente.[in] alignment
Der Ausrichtungswert, der eine integrale Potenz von 2 sein muss.[in] filename
Ein Zeiger auf den Namen der Quelldatei, die NULLoder - Vorgang Zuordnungen angefordert hat.[in] linenumber
Zeilennummer in der Quelldatei, in der NULLoder Operation Zuordnungen angefordert wurde.
Rückgabewert
_aligned_recalloc_dbg gibt einen void-Zeiger auf den neu zugeteilten (und ggf. verschoben) Speicherblock zurück.Der Rückgabewert ist NULL , wenn die Größe des Puffers - Argument ist und nicht NULList oder wenn nicht genügend verfügbaren Arbeitsspeicher vorhanden ist, um die angegebene Größe des Blocks zu erweitern.Im ersten Fall wird der ursprüngliche Block freigegeben.Im zweiten Fall ist der ursprüngliche Block unverändert.Der Rückgabewert zeigt auf ein garantiert der Speicherplatz zum Speichern eines beliebigen Typs Objekt ordnungsgemäß ausgerichtet werden soll.Um einen Zeiger auf einen anderen Typ als void abzurufen, verwenden Sie eine Typumwandlung im Rückgabewert.
Es ist ein Fehler, um Arbeitsspeicher neu zuzuteilen und der Ausrichtung eines Blocks zu ändern.
Hinweise
_aligned_recalloc_dbg ist eine Debugversion der _aligned_recalloc-Funktion.Wenn _DEBUG nicht definiert ist, wird jeder Aufruf von _aligned_recalloc_dbg zu einem Aufruf von _aligned_recallocreduziert._aligned_recalloc teilen und _aligned_recalloc_dbg Basisheap einen Speicherblock im neu zu _aligned_recalloc_dbg bringt jedoch einige Debugfunktionen unter: Puffer auf beiden Seiten des Benutzers zu einem Teil des Verlusten Parameter Blockformat, um bestimmte Typen von Zuordnungen zu verfolgen und filename/linenumber Informationen zu testen, Blocks um den Ursprung Zuordnung von Anforderungen zu bestimmen.
_aligned_recalloc_dbg weist den angegebenen Speicherblock mit etwas mehr Platz als die angeforderte Größe neu (*) sizenum die möglicherweise größer oder kleiner als die Größe des belegten Speicherblocks ursprünglich sein.Das zusätzliche Speicherplatz wird vom Debugheap Manager, um die Programmdebuginformationen Speicherblöcke zu verknüpfen und die Anwendung bereitzustellen und Debuggen mit Headerinformationen Puffer zu überschreiben.Die ergäbe Neuzuordnung kann das Verschieben des ursprünglichen Speicherblocks an einen anderen Speicherort im Heap als auch beim Ändern der Größe des Speicherblocks.Der Benutzer des Blocks wird mit dem Wert 0xCD gefüllt und die überschreibens Puffer werden mit 0xFD gefüllt.
_aligned_recalloc_dbg legt diesen fest ENOMEM zu errno , wenn eine Speicherbelegung fehlschlägt. EINVAL wird zurückgegeben, wenn der Arbeitsspeicher benötigt wird (einschließlich Mehraufwand bereits erwähnt) _HEAP_MAXREQüberschreitet.Weitere Informationen zu diesem und anderen Fehlercodes finden Sie unter errno, _doserrno, _sys_errlist und _sys_nerr.
Außerdem _aligned_recalloc_dbg überprüft seine Parameter.Wenn alignment keine Potenz von 2 (null) ist, Aufrufe dieser Funktion der ungültige Parameter für, wie in Parametervalidierungbeschrieben.Wenn die Ausführung zulässig ist, um fortzufahren, gibt diese Funktion NULL zurück und legt ihn fest. EINVALzu errno
Weitere Informationen zum Speicherblöcke in der Debugversion des Basisheaps zugeordnet, initialisiert und verwaltet werden, finden Sie unter Speicherverwaltung und Debugheap.Weitere Informationen über die Unterschiede zwischen den Aufrufen einer Funktion heap Standard für die Debugversion in einem Debugbuild einer Anwendung finden Sie unter Verwenden der Debugversion für die Grundversion.
Anforderungen
Routine |
Erforderlicher Header |
|---|---|
_aligned_recalloc_dbg |
<crtdbg.h> |
Weitere Informationen finden Sie unter Kompatibilität Kompatibilität in der Einführung.
Bibliotheken
Debugversionen von nur C .
.NET Framework-Entsprechung
Nicht zutreffend. Um die Standard-C-Funktion aufrufen, verwenden Sie PInvoke. Weitere Informationen finden Sie unter Plattformaufruf-Beispiele.