Freigeben über


_aligned_msize

Gibt die Größe eines Speicherblocks zurück, der im Heap zugeordnet wird.

size_t _msize(
   void *memblock,
   size_t alignment,
   size_t offset
);

Parameter

  • [in] memblock
    Zeiger zum Speicherblock.

  • [in] alignment
    Der Ausrichtungswert, der eine ganzzahlige Potenz von 2 sein muss.

  • [in] 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 Funktion _aligned_msize wird der Schriftgrad, in Bytes, des Speicherblocks zurück, der durch einen Aufruf von _aligned_malloc oder _aligned_realloc zugeordnet sind. 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, wird _aligned_msize von _aligned_msize_dbg auf. Weitere Informationen dazu, wie der Heap während des Debuggingsprozesses verwaltet wird, finden Sie unter Der CRT-Debugheap.

Diese Funktion überprüft seine Parameter. Wenn memblock ein NULL-Zeiger oder alignment keine Potenz von 2 ist, ruft _msize einen Handler für ungültige Parameter auf, wie in unter Parametervalidierung beschrieben. Wenn der Fehler behandelt wird, legt die Funktion errno auf EINVAL fest und gibt -1 zurück.

Anforderungen

Routine

Erforderlicher Header

_msize

<malloc.h>

Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität in der Einführung.

Bibliotheken

Alle Versionen 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.

Siehe auch

Referenz

Speicherbelegung