_aligned_offset_recalloc_dbg
veya _aligned_offset_malloc ile _aligned_malloc ayrılan bir bellek bloğunun boyutunu değiştirir ve belleği 0 olarak başlatır (yalnızca hata ayıklama sürümü).
Sözdizimi
void * _aligned_offset_recalloc_dbg(
void *memblock,
size_t num,
size_t size,
size_t alignment,
size_t offset,
const char *filename,
int linenumber
);
Parametreler
memblock
Geçerli bellek bloğu işaretçisi.
number
Öğe sayısı.
size
Her öğenin bayt cinsinden uzunluğu.
alignment
Hizalama değeri, 2 tamsayı gücü olmalıdır.
offset
Hizalamayı zorlamak için bellek ayırmaya uzaklık.
filename
veya realloc işlemini NULListeyen kaynak dosyanın adına yönelik işaretçi.
linenumber
Kaynak dosyada, realloc işleminin istendiği veya NULLsatır numarası.
Dönüş değeri
_aligned_offset_recalloc_dbg yeniden ayrılan (ve büyük olasılıkla taşınan) bellek bloğu için geçersiz bir işaretçi döndürür. Dönüş değeri, NULL boyutun sıfır olması ve arabellek bağımsız değişkeninin NULLolmaması veya bloğu verilen boyuta genişletmek için yeterli kullanılabilir bellek olmamasıdır. İlk durumda, özgün blok serbesttir. İkinci durumda, özgün blok değiştirilmez. Dönüş değeri, herhangi bir nesne türünün depolaması için uygun olan bir depolama alanını gösterir. dışında voidbir türe işaretçi almak için dönüş değerinde tür tür ataması kullanın.
Açıklamalar
_aligned_offset_realloc_dbg işlevin _aligned_offset_recalloc hata ayıklama sürümüdür. Tanımlanmadığında _DEBUG , çağrısının her _aligned_offset_recalloc_dbg biri öğesine yapılan çağrıya _aligned_offset_recallocindirgenir. Hem hem _aligned_offset_recalloc_dbg de _aligned_offset_recalloc temel yığındaki bir bellek bloğunu yeniden ayırın, ancak _aligned_offset_recalloc_dbg birkaç hata ayıklama özelliği içerir: sızıntıları test etmek için bloğun kullanıcı bölümünün her iki tarafındaki arabellekler ve filename/linenumber ayırma isteklerinin kaynağını belirlemeye yönelik bilgiler. Blok türü parametresiyle belirli ayırma türlerini izlemek, hizalanmış ayırmalar için desteklenen bir hata ayıklama özelliği değildir. Hizalanmış ayırmalar bir _NORMAL_BLOCK blok türü olarak görünür.
_aligned_offset_realloc_dbg belirtilen bellek bloğunu istenenden newSizebiraz daha fazla alanla yeniden ayırır. newSize özgün olarak ayrılan bellek bloğunun boyutundan büyük veya daha küçük olabilir. Ek alan, hata ayıklama yığın yöneticisi tarafından hata ayıklama bellek bloklarını bağlamak ve uygulamaya hata ayıklama üst bilgisi bilgileri sağlamak ve arabelleklerin üzerine yazmak için kullanılır. Yeniden konumlandırma hem özgün bellek bloğunu yığında farklı bir konuma taşıyabilir hem de bellek bloğunun boyutunu değiştirebilir. Bellek bloğu taşınırsa, özgün bloğun içeriğinin üzerine yazılır.
Bu işlev, bellek ayırmanın başarısız olup olmadığını veya istenen boyutun (number * size) değerinden _HEAP_MAXREQbüyük olup olmadığını olarak ayarlar.errno ENOMEM hakkında errnodaha fazla bilgi için bkz.errno , _doserrno, _sys_errlistve _sys_nerr. Ayrıca parametrelerini _aligned_offset_recalloc_dbg doğrular. alignment 2'nin gücü değilse veya sıfır olmayan ve istenenden sizebüyük veya buna eşitseoffset, bu işlev Parametre doğrulama bölümünde açıklandığı gibi geçersiz parametre işleyicisini çağırır. Yürütmenin devam etmesi için izin verilirse, bu işlev döndürür NULL ve olarak EINVALayarlanırerrno.
Temel yığının hata ayıklama sürümünde bellek bloklarının nasıl ayrıldığı, başlatıldığı ve yönetildiğini öğrenmek için bkz . CRT hata ayıklama yığını ayrıntıları. Ayırma bloğu türleri ve bunların nasıl kullanıldığı hakkında bilgi için bkz . Hata ayıklama yığınındaki blok türleri. Standart yığın işlevleri ile bunların hata ayıklama sürümleri arasındaki farklar hakkında bilgi için bkz . Yığın ayırma işlevlerinin sürümlerinde hata ayıklama.
Gereksinimler
| Yordam | Gerekli başlık |
|---|---|
_aligned_offset_recalloc_dbg |
<malloc.h> |