_aligned_recalloc
Modifica la dimensione di un blocco di memoria che è stato allocato con _aligned_malloc o _aligned_offset_malloc e inizializza la memoria a 0.
void * _aligned_recalloc(
void *memblock,
size_t num,
size_t size,
size_t alignment
);
Parametri
[in] memblock
Il puntatore al blocco di memoria corrente.[in] num
Numero di elementi.[in] size
La dimensione di ciascun elemento in byte.[in] alignment
Il valore di allineamento, che deve essere una potenza intera di 2.
Valore restituito
_aligned_recalloc restituisce un puntatore void al blocco di memoria riallocato (ed eventualmente spostato). Il valore restituito è NULL se la dimensione è zero e l'argomento del 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 rimane invariato. I valore restituito punta ad uno spazio di memoria che garantisce l'allineamento adeguato per l'archiviazione di qualsiasi tipo di oggetto. Per ottenere un puntatore a un tipo diverso da void, utilizzare un cast di tipo sul valore di ritorno.
È un errore riallocare la memoria e modificare l'allineamento di un blocco.
Note
_aligned_recalloc è basato su malloc. Per ulteriori informazioni sull'utilizzo di _aligned_offset_malloc, vedere malloc.
Questa funzione imposta errno in ENOMEM se non è riuscita l'allocazione della memoria o se la dimensione richiesta è maggiore di _HEAP_MAXREQ. Per ulteriori informazioni su errno, vedere errno, _doserrno, _sys_errlist, and _sys_nerr. Inoltre, _aligned_recalloc convalida i suoi parametri. Se alignment non è una potenza di 2, questa funzione chiama il gestore di parametro non valido, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, questa funzione restituisce NULL e imposta errno su EINVAL.
Requisiti
Routine |
Intestazione obbligatoria |
|---|---|
_aligned_recalloc |
<malloc.h> |
Equivalente .NET Framework
Non applicabile. Per chiamare la funzione standard C, utilizzare PInvoke. Per ulteriori informazioni, vedere Esempi di Invocazione della Piattaforma.