_aligned_offset_recalloc

Modifica le dimensioni di un blocco di memoria allocato con _aligned_malloc o _aligned_offset_malloc e inizializza la memoria su 0.

Sintassi

void * _aligned_offset_recalloc(
   void *memblock,
   size_t num,
   size_t size,
   size_t alignment,
   size_t offset
);

Parametri

memblock
Puntatore al blocco di memoria corrente.

number
Numero di elementi.

size
Lunghezza in byte di ogni elemento.

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

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

Valore restituito

_aligned_offset_recalloc restituisce un puntatore void al blocco di memoria riallocato (e possibilmente spostato). Il valore restituito è NULL se la dimensione è zero e l'argomento buffer non NULLè o se la memoria disponibile non è sufficiente per espandere il blocco fino alle dimensioni specificate. 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 allineato in modo adeguato 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.

_aligned_offset_recalloc è contrassegnato __declspec(noalias) e __declspec(restrict), il che significa che la funzione non deve modificare le variabili globali e che il puntatore restituito non è aliasato. Per altre informazioni, vedere noalias e restrict.

Osservazioni:

Analogamente _aligned_offset_malloca , _aligned_offset_recalloc consente l'allineamento di una struttura in corrispondenza di un offset all'interno della struttura.

_aligned_offset_recalloc è basato su malloc. Per altre informazioni sull'uso di _aligned_offset_malloc, vedere malloc. Se memblock è NULL, la funzione chiama _aligned_offset_malloc internamente.

La funzione imposta errno su ENOMEM se l'allocazione di memoria non riesce o se la dimensione richiesta (number * size) è maggiore di _HEAP_MAXREQ. Per altre informazioni su errno, vedere errno, _doserrno, _sys_errliste _sys_nerr. _aligned_offset_recalloc, inoltre, convalida i propri parametri. Se alignment non è una potenza pari a 2 o se offset è diverso da zero e maggiore o uguale a quello richiesto size, questa funzione richiama il gestore di parametri non validi, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, la funzione restituisce NULL e imposta errno su EINVAL.

Per impostazione predefinita, lo stato globale di questa funzione è limitato all'applicazione. Per modificare questo comportamento, vedere Stato globale in CRT.

Requisiti

Vedi anche

Allineamento dei dati
_recalloc
_aligned_recalloc