Fungsi QueryVirtualMemoryInformation (memoryapi.h)

  • Artikel

Fungsi QueryVirtualMemoryInformation mengembalikan informasi tentang halaman atau sekumpulan halaman dalam ruang alamat virtual dari proses yang ditentukan.

Sintaks

BOOL QueryVirtualMemoryInformation(
  [in]            HANDLE                         Process,
  [in]            const VOID                     *VirtualAddress,
  [in]            WIN32_MEMORY_INFORMATION_CLASS MemoryInformationClass,
  [out]           PVOID                          MemoryInformation,
  [in]            SIZE_T                         MemoryInformationSize,
  [out, optional] PSIZE_T                        ReturnSize
);

Parameter

[in] Process

Handel untuk proses dalam konteks halaman yang akan dikueri berada.

[in] VirtualAddress

Alamat wilayah halaman yang akan dikueri. Nilai ini dibulatkan ke bawah ke batas alamat halaman host berikutnya.

[in] MemoryInformationClass

Kelas informasi memori tentang mana yang akan diambil informasinya. Satu-satunya nilai yang didukung adalah MemoryRegionInfo.

[out] MemoryInformation

Penunjuk ke buffer yang menerima informasi yang ditentukan.

Jika parameter MemoryInformationClass memiliki nilai MemoryRegionInfo, parameter ini harus menunjuk ke struktur WIN32_MEMORY_REGION_INFORMATION .

[in] MemoryInformationSize

Menentukan panjang dalam byte buffer informasi memori.

[out, optional] ReturnSize

Penunjuk opsional yang, jika ditentukan, menerima jumlah byte yang ditempatkan dalam buffer informasi memori.

Nilai kembali

Mengembalikan TRUE pada keberhasilan. Mengembalikan FALSE untuk kegagalan. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Jika parameter MemoryInformationClass memiliki nilai MemoryRegionInfo, parameter MemoryInformation harus menunjuk ke struktur WIN32_MEMORY_REGION_INFORMATION . Parameter VirtualAddress harus menunjuk ke alamat dalam alokasi memori yang valid. Jika parameter VirtualAddress menunjuk ke wilayah memori yang tidak dialokasikan, fungsi gagal.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 10, versi 1607 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2016 [hanya aplikasi desktop]
Target Platform Windows
Header memoryapi.h (termasuk Windows.h)
Pustaka Onecore.lib
DLL Api-ms-win-core-memory-l1-1-4.dll

Lihat juga

GetLastError

MEMORY_BASIC_INFORMATION

WIN32_MEMORY_REGION_INFORMATION