Bagikan melalui

Metode IHostMAlloc::DebugAlloc

Meminta agar host mengalokasikan jumlah memori yang ditentukan dari heap, dan juga melacak di mana memori dialokasikan.

Sintaks

HRESULT DebugAlloc (  
    [in]  SIZE_T  cbSize,
    [in]  EMemoryCriticalLevel dwCriticalLevel,
    [in]  char*   pszFileName,
    [in]  int     iLineNo,
    [out] void**  ppMem  
);

Parameter

cbSize
[in] Ukuran, dalam byte, dari permintaan alokasi memori saat ini.

dwCriticalLevel
[in] Salah satu nilai EMMemoryCriticalLevel, yang menunjukkan dampak kegagalan alokasi.

pszFileName
[in] File kode dari yang dapat dieksekusi yang sedang di-debug.

iLineNo
[in] Nomor baris pada pszFileName di mana alokasi diminta.

ppMem
[out] Penunjuk ke memori yang dialokasikan, atau nol jika permintaan tidak dapat diselesaikan.

Tampilkan Nilai

HRESULT Deskripsi
S_OK DebugAlloc berhasil dikembalikan.
HOST_E_CLRNOTAVAILABLE Runtime bahasa umum belum dimuat ke dalam proses, atau runtime bahasa umum dalam status yaitu tidak dapat menjalankan kode aman atau memproses panggilan dengan sukses.
HOST_E_TIMEOUT Waktu panggilan habis.
HOST_E_NOT_OWNER Pemanggil tidak memiliki kunci.
HOST_E_ABANDONED Peristiwa dibatalkan saat rangkaian atau fiber yang diblokir sedang menunggunya.
E_FAIL Kegagalan katastrofe yang tidak diketahui terjadi. Saat metode menampilkan E_FAIL, CLR tidak lagi dapat digunakan dalam proses. Panggilan berikutnya ke metode hosting menampilkan HOST_E_CLRNOTAVAILABLE.
E_OUTOFMEMORY Tidak cukup memori yang tersedia untuk menyelesaikan permintaan alokasi.

Keterangan

Runtime bahasa umum mendapatkan penunjuk antarmuka ke instans IHostMalloc dengan memanggil metode IHostMemoryManager::CreateMalloc. DebugAlloc memungkinkan runtime untuk mendapatkan informasi file kode untuk digunakan selama penelusuran kesalahan.

Persyaratan

Platform: Lihat Persyaratan Sistem.

Header: MSCorEE.h

Pustaka: Disertakan sebagai sumber daya di MSCorEE.dll

Versi .NET Framework: Tersedia mulai dari 2.0

Lihat juga

  • Last updated on