Metode IHostMemoryManager::VirtualQuery

Berfungsi sebagai pembungkus logis untuk fungsi Win32 yang sesuai. Implementasi VirtualQuery Win32 mengambil informasi tentang rentang halaman di ruang alamat virtual dari proses panggilan.

Sintaks

HRESULT VirtualQuery (  
    [in]  void*    lpAddress,  
    [out] void*    lpBuffer,  
    [in]  SIZE_T   dwLength,  
    [out] SIZE_T*  pResult  
);  

Parameter

lpAddress
[masuk] Penunjuk ke alamat dalam memori virtual untuk dipertanyakan.

lpBuffer
[keluar] Penunjuk ke struktur yang berisi informasi tentang wilayah memori yang ditentukan.

dwLength
[masuk] Ukuran, dalam byte, dari buffer yang lpBuffer menunjuk ke.

pResult
[keluar] Penunjuk ke jumlah byte yang dikembalikan oleh buffer informasi.

Tampilkan Nilai

HRESULT	Deskripsi
S_OK	VirtualQuery berhasil dikembalikan.
HOST_E_CLRNOTAVAILABLE	Runtime bahasa umum (CLR) belum dimuat ke dalam proses, atau CLR berada dalam status yang tidak dapat menjalankan kode terkelola atau tidak berhasil memproses panggilan.
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.

Keterangan

VirtualQuery menyediakan informasi tentang rentang halaman di ruang alamat virtual dari proses panggilan. Implementasi ini menetapkan nilai pResult parameter ke jumlah byte yang dikembalikan dalam buffer informasi, dan menampilkan nilai HRESULT. Dalam fungsi Win32 VirtualQuery, nilai yang dikembalikan adalah ukuran buffer. Untuk informasi selengkapnya, lihat dokumentasi Platform Windows.

Penting

Implementasi sistem operasi tidak menimbulkan kebuntuan VirtualQuery dan dapat berjalan hingga selesai dengan rangkaian acak yang ditangguhkan dalam kode pengguna. Berhati-hatilah saat menerapkan versi yang dihosting dari metode ini.

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

• Antarmuka IHostMemoryManager