_aligned_msize

  • Artikel

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. Informationen zum Ändern dieses Verhaltens finden Sie im Global state in the CRT.

Anforderungen

Routine Erforderlicher Header
_aligned_msize <malloc.h>

Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.

Bibliotheken

Alle Versionen der C-Laufzeitbibliotheken.

Siehe auch

Speicherzuweisung