_aligned_offset_recalloc
Zmienia rozmiar bloku pamięci, która została przydzielona z _aligned_malloc lub _aligned_offset_malloc i inicjalizuje pamięć na 0.
void * _aligned_offset_recalloc(
void *memblock,
size_t num,
size_t size,
size_t alignment,
size_t offset
);
Parametry
memblock
Bieżący wskaźnik bloku pamięci.num
Liczba elementów.size
Długość w bajtach każdego elementu.alignment
Wartość wyrównania musi być całkowitą potęgą liczby 2.offset
Przesunięcie w alokacji pamięci, aby wymusić wyrównanie.
Wartość zwracana
_aligned_offset_recallocZwraca void wskaźnik do bloku pamięci reallocated (i ewentualnie przeniesiony).Zwracana jest wartość NULL , jeśli rozmiar jest zero, a argument bufor nie jest NULL, lub jeśli jest za mało dostępnej pamięci, aby rozwinąć bloku do podanego rozmiaru.W pierwszym przypadku oryginalnego bloku jest zwalniana.W drugim przypadku oryginalnego bloku jest bez zmian.Zwracana wartość wskazuje miejsce w magazynie jest gwarantowane zostały odpowiednio dostosowane do przechowywania dowolnego typu obiektu.Aby uzyskać wskaźnika typu innego niż void, typ, oddanych na wartości zwracanej.
_aligned_offset_recallocjest oznaczony jako __declspec(noalias) i __declspec(restrict), co oznacza, że funkcja zagwarantowane jest nie do modyfikacji zmiennych globalnych, i że zwrócony wskaźnik nie jest aliasu.Aby uzyskać więcej informacji, zobacz noalias i ograniczyć.
Uwagi
Podobnie jak _aligned_offset_malloc, _aligned_offset_recalloc umożliwia struktury wyrównania przesunięcia w ramach struktury.
_aligned_offset_recallocjest oparta na malloc.Aby uzyskać więcej informacji na temat za pomocą _aligned_offset_malloc, zobacz malloc.Jeśli memblock jest NULL, wywołania funkcji _aligned_offset_malloc wewnętrznie.
Ta funkcja ustawia errno do ENOMEM czy alokacja pamięci nie powiodła się, czy żądany rozmiar (num * size) była większa niż _HEAP_MAXREQ.Aby uzyskać więcej informacji o errno, zobacz errno, _doserrno, _sys_errlist i _sys_nerr.Ponadto _aligned_offset_recalloc sprawdza poprawność jego parametry.Jeśli alignment nie jest potęgą liczby 2 lub jeśli offset jest większa niż lub równa żądanym rozmiarze i różną od zera, funkcja ta wywołuje obsługi nieprawidłowy parametr, jak opisano w Sprawdzanie poprawności parametru.Jeśli wykonanie mogą w dalszym ciągu, funkcja ta zwraca NULL i ustawia errno do EINVAL.
Wymagania
Rozpoczęto wykonywanie procedury |
Wymaganego nagłówka |
|---|---|
_aligned_offset_recalloc |
<malloc.h> |
Odpowiednik w programie .NET Framework
Nie dotyczy. Aby wywołać standardowych funkcji C, należy użyć PInvoke. Aby uzyskać więcej informacji, zobacz Przykłady wywołać platformy.