_aligned_msize
Gibt die Größe eines im Heap belegten Speicherblocks zurück.
Syntax
size_t _aligned_msize(
void *memblock,
size_t alignment,
size_t offset
);
Parameter
memblock
Zeiger zum Speicherblock.
alignment
Der Ausrichtungswert, der eine ganzzahlige Potenz von 2 sein muss.
offset
Der Offset in der Speicherbelegung zum Erzwingen der Ausrichtung.
Rückgabewert
Gibt die Größe (in Bytes) als ganze Zahl ohne Vorzeichen zurück.
Hinweise
Die _aligned_msize Funktion gibt die Größe des speicherblocks in Byte zurück, der durch einen Aufruf oder _aligned_realloceinen ._aligned_malloc Die alignment- und offset-Werte müssen mit den Werten identisch sein, die an die Funktion übergeben wurden, die den Speicherblock belegt hat.
Wenn die Anwendung mit einer Debugversion der C-Laufzeitbibliotheken verknüpft ist, _aligned_msize wird sie aufgelöst._aligned_msize_dbg Weitere Informationen dazu, wie der Heap während des Debuggingvorgangs verwaltet wird, finden Sie im CRT-Debug-Heap.
Diese Funktion überprüft seine Parameter. Wenn memblock es sich um einen Nullzeiger handelt oder alignment keine Potenz von 2 ist, _aligned_msize wird ein ungültiger Parameterhandler aufgerufen, wie in der Parameterüberprüfung beschrieben. Wenn der Fehler behandelt wird, legt die Funktion errno auf EINVAL fest und gibt -1 zurück.
Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Wie Sie dieses Verhalten ändern, erfahren Sie unter Globaler Status in der CRT.
Anforderungen
| Routine | Erforderlicher Header |
|---|---|
_aligned_msize |
<malloc.h> |
Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.
Libraries
Alle Versionen der C-Laufzeitbibliotheken.