Fungsi HeapReAlloc (heapapi.h)

Mengalokasikan blok memori dari timbunan. Fungsi ini memungkinkan Anda mengubah ukuran blok memori dan mengubah properti blok memori lainnya. Memori yang dialokasikan tidak dapat dipindahkan.

DECLSPEC_ALLOCATOR LPVOID HeapReAlloc(
  [in] HANDLE                 hHeap,
  [in] DWORD                  dwFlags,
  [in] _Frees_ptr_opt_ LPVOID lpMem,
  [in] SIZE_T                 dwBytes
);

[in] hHeap

Handel ke timbunan dari mana memori akan dialokasikan kembali. Handel ini dikembalikan oleh fungsi HeapCreate atau GetProcessHeap .

[in] dwFlags

Opsi realokasi tumpukan. Menentukan nilai akan menggantikan nilai terkait yang ditentukan dalam parameter flOptions saat heap dibuat dengan menggunakan fungsi HeapCreate . Parameter ini bisa menjadi satu atau beberapa nilai berikut.

[in] lpMem

Penunjuk ke blok memori yang di-realokasi fungsi. Penunjuk ini dikembalikan oleh panggilan sebelumnya ke fungsi HeapAlloc atau HeapReAlloc .

[in] dwBytes

Ukuran baru blok memori, dalam byte. Ukuran blok memori dapat ditingkatkan atau dikurangi dengan menggunakan fungsi ini.

Jika heap yang ditentukan oleh parameter hHeap adalah heap "non-growable", dwBytes harus kurang dari 0x7FFF8. Anda membuat tumpukan yang tidak dapat tumbuh dengan memanggil fungsi HeapCreate dengan nilai bukan nol.

Jika fungsi berhasil, nilai yang dikembalikan adalah penunjuk ke blok memori yang dialokasikan kembali.

Jika fungsi gagal dan Anda belum menentukan HEAP_GENERATE_EXCEPTIONS, nilai yang dikembalikan adalah NULL.

Jika fungsi gagal dan Anda telah menentukan HEAP_GENERATE_EXCEPTIONS, fungsi dapat menghasilkan salah satu pengecualian yang tercantum dalam tabel berikut. Untuk informasi selengkapnya, lihat GetExceptionCode.

Perataan memori yang dikembalikan oleh HeapReAllocMEMORY_ALLOCATION_ALIGNMENT di WinNT.h:

#if defined(_WIN64) || defined(_M_ALPHA)
#define MEMORY_ALLOCATION_ALIGNMENT 16
#else
#define MEMORY_ALLOCATION_ALIGNMENT 8
#endif

Jika fungsi gagal, fungsi tidak memanggil SetLastError. Aplikasi tidak dapat memanggil GetLastError untuk informasi kesalahan yang diperluas.

Jika HeapReAlloc berhasil, heapReAlloc mengalokasikan setidaknya jumlah memori yang diminta.

Jika HeapReAlloc gagal, memori asli tidak dikosongkan, dan handel dan penunjuk asli masih valid.

HeapReAlloc dijamin akan mempertahankan konten memori yang direalokasikan, bahkan jika memori baru dialokasikan di lokasi yang berbeda. Proses mempertahankan konten memori melibatkan operasi salinan memori yang berpotensi sangat memakan waktu.

Untuk membebaskan blok memori yang dialokasikan oleh HeapReAlloc, gunakan fungsi HeapFree .

Serialisasi memastikan pengecualian timbal balik ketika dua utas atau lebih mencoba mengalokasikan atau membebaskan blok secara bersamaan dari timbunan yang sama. Ada biaya performa kecil untuk serialisasi, tetapi harus digunakan setiap kali beberapa utas mengalokasikan dan membebaskan memori dari tumpukan yang sama. Mengatur nilai HEAP_NO_SERIALIZE menghilangkan pengecualian timbal balik pada tumpukan. Tanpa serialisasi, dua utas atau lebih yang menggunakan handel tumpukan yang sama mungkin mencoba mengalokasikan atau membebaskan memori secara bersamaan, kemungkinan menyebabkan kerusakan dalam tumpukan. Oleh karena itu, nilai HEAP_NO_SERIALIZE dapat digunakan dengan aman hanya dalam situasi berikut:

• Proses ini hanya memiliki satu utas.
• Proses ini memiliki beberapa utas, tetapi hanya satu utas yang memanggil fungsi heap untuk timbunan tertentu.
• Proses ini memiliki beberapa utas, dan aplikasi menyediakan mekanismenya sendiri untuk pengecualian bersama ke timbunan tertentu.

Fungsi Timbunan

HeapAlloc

HeapFree

Fungsi Manajemen Memori

Api Vertdll tersedia di enklave VBS