_aligned_msize_dbg

Restituisce le dimensioni di un blocco di memoria allocato nell'heap (solo versione di debug).

Sintassi

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

Parametri

memblock
Puntatore al blocco di memoria.

alignment
Valore di allineamento, che deve essere una potenza intera di 2.

offset
Offset nell'allocazione di memoria per imporre l'allineamento.

Valore restituito

Restituisce le dimensioni (in byte) come intero senza segno.

Osservazioni:

I valori alignment e offset devono corrispondere ai valori passati alla funzione che ha allocato il blocco.

_aligned_msize_dbg è una versione di debug della _aligned_msize funzione. Quando _DEBUG non è definito, ogni chiamata a _aligned_msize_dbg viene ridotta a una chiamata a _aligned_msize. Sia _aligned_msize che _aligned_msize_dbg calcolano le dimensioni di un blocco di memoria nell'heap di base, ma _aligned_msize_dbg aggiunge una funzionalità di debug: include i buffer su entrambi i lati della parte utente del blocco di memoria nelle dimensioni restituite.

Questa funzione convalida il relativo parametro. Se memblock è un puntatore Null o alignment non è una potenza pari a 2, _msize richiama un gestore di parametri non validi, come descritto in Convalida dei parametri. Se l'errore viene gestito, la funzione imposta errno su EINVAL e restituisce -1.

Per informazioni sulla modalità di allocazione, inizializzazione e gestione dei blocchi di memoria nella versione di debug dell'heap di base, vedere Dettagli dell'heap di debug CRT. Per informazioni sui tipi di blocchi di allocazione e sul modo in cui vengono usati, vedere Tipi di blocchi nell'heap di debug. Per informazioni sulle differenze tra le funzioni heap standard e le relative versioni di debug, vedere Eseguire il debug delle versioni delle funzioni di allocazione dell'heap.

Requisiti

Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).

Librerie

Solo le versioni di debug delle librerie di runtime di C.

Vedi anche

Allocazione di memoria