_aligned_realloc_dbg
Modifica la dimensione di un blocco di memoria allocato mediante _aligned_malloc o _aligned_offset_malloc (solo versione di debug).
void * _aligned_realloc_dbg( void *memblock, size_t size, size_t alignment, const char *filename, int linenumber );
Parametri
[in] memblock
Puntatore al blocco di memoria corrente.[in] size
Dimensione dell'allocazione di memoria richiesta.[in] alignment
Valore di allineamento, che deve essere una potenza intera di 2.[in] filename
Puntatore al nome del file di origine che ha richiesto l'operazione realloc oppure NULL.[in] linenumber
Numero di riga nel file di origine in cui è stata richiesta l'operazione realloc oppure NULL.
Valore restituito
_aligned_realloc_dbg restituisce un puntatore void al blocco di memoria riallocato (e possibilmente spostato). Il valore restituito è NULL se la dimensione è pari a zero e l'argomento relativo al buffer non è NULL o se non è disponibile memoria sufficiente per espandere il blocco alla dimensione specificata. Nel primo caso il blocco originale viene liberato. Nel secondo caso il blocco originale resta invariato. Il valore restituito punta a uno spazio di archiviazione che garantisce il corretto allineamento per l'archiviazione di qualsiasi tipo di oggetto. Per ottenere un puntatore a un tipo diverso da void, usare un cast del tipo sul valore restituito.
Riallocare memoria modificando l'allineamento di un blocco è un errore.
Note
_aligned_realloc_dbg è una versione di debug della funzione _aligned_realloc. Quando _DEBUG non è definito, ogni chiamata a _aligned_realloc_dbg viene ridotta a una chiamata a _aligned_realloc. Sia _aligned_realloc che _aligned_realloc_dbg riallocano un blocco di memoria nell'heap di base, ma _aligned_realloc_dbg contiene diverse funzionalità di debug: buffer presenti a entrambi i lati della parte del blocco da verificare per le perdite, un parametro di tipo del blocco per registrare i tipi specifici di allocazioni e informazioni su filename/linenumber per determinare l'origine delle richieste di allocazione.
_aligned_realloc_dbg rialloca il blocco di memoria specificato con una quantità di spazio appena superiore a quella richiesta da newSize. newSize potrebbe essere maggiore o minore della dimensione del blocco di memoria allocato in origine. Lo spazio aggiuntivo viene usato dal gestore dell'heap di debug per collegare i blocchi di memoria di debug e per fornire all'applicazione informazioni di intestazione di debug e buffer di sovrascrittura. La riallocazione potrebbe comportare lo spostamento del blocco di memoria originale in un'altra posizione nell'heap nonché la modifica della dimensione del blocco di memoria. Se il blocco di memoria viene spostato, i contenuti del blocco originale verranno sovrascritti.
_aligned_realloc_dbg imposta errno su ENOMEM se un'allocazione di memoria ha esito negativo o se la quantità di memoria richiesta (incluso l'overhead citato in precedenza) supera _HEAP_MAXREQ. Per informazioni su questo e altri codici di errore, vedere errno, _doserrno, _sys_errlist, and _sys_nerr.
_aligned_realloc_dbg, inoltre, convalida i propri parametri. Se alignment non è una potenza di 2, questa funzione richiama il gestore di parametro non valido, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, la funzione restituisce NULL e imposta errno su EINVAL.
Per informazioni sulle modalità di allocazione, inizializzazione e gestione dei blocchi di memoria nella versione di debug dell'heap di base, vedere Informazioni dettagliate sull'heap di debug CRT. Per informazioni sui tipi di blocchi di allocazione e su come vengono usati, vedere Tipi di blocchi sull'heap di debug. Per informazioni sulle differenze tra chiamare una funzione standard dell'heap e la sua versione di debug nella build di debug di un'applicazione, vedere Versioni di debug di funzioni di allocazione heap.
Requisiti
Routine |
Intestazione obbligatoria |
|---|---|
_aligned_realloc_dbg |
<crtdbg.h> |
Per altre informazioni sulla compatibilità, vedere la sezione Compatibilità nell'introduzione.
Librerie
Solo versioni di debug delle librerie di runtime C.
Equivalente .NET Framework
Non applicabile. Per chiamare la funzione C standard, usare PInvoke. Per altre informazioni, vedere Esempi di platform invoke.