Fungsi QueryWorkingSetEx (psapi.h)

Artikel
03/04/2024

Mengambil informasi yang diperluas tentang halaman di alamat virtual tertentu di ruang alamat proses yang ditentukan.

Sintaks

BOOL QueryWorkingSetEx(
  [in]      HANDLE hProcess,
  [in, out] PVOID  pv,
  [in]      DWORD  cb
);

Parameter

[in] hProcess

Handel untuk proses. Handel harus memiliki hak akses PROCESS_QUERY_INFORMATION . Untuk informasi selengkapnya, lihat Keamanan Proses dan Hak Akses.

[in, out] pv

Penunjuk ke array struktur PSAPI_WORKING_SET_EX_INFORMATION . Pada input, setiap item dalam array menentukan alamat virtual yang menarik. Pada output, setiap item dalam array menerima informasi tentang halaman virtual yang sesuai.

[in] cb

Ukuran buffer pv , dalam byte.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Tidak seperti fungsi QueryWorkingSet , yang terbatas pada rangkaian proses target yang berfungsi, fungsi QueryWorkingSetEx dapat digunakan untuk mengkueri alamat yang tidak dalam proses set kerja tetapi masih merupakan bagian dari proses, seperti AWE dan halaman besar.

Dimulai dengan Windows 7 dan Windows Server 2008 R2, Psapi.h menetapkan nomor versi untuk fungsi PSAPI. Nomor versi PSAPI memengaruhi nama yang digunakan untuk memanggil fungsi dan pustaka yang harus dimuat program.

Jika PSAPI_VERSION adalah 2 atau lebih besar, fungsi ini didefinisikan sebagai K32QueryWorkingSetEx di Psapi.h dan diekspor di Kernel32.lib dan Kernel32.dll. Jika PSAPI_VERSION adalah 1, fungsi ini didefinisikan sebagai QueryWorkingSetEx di Psapi.h dan diekspor di Psapi.lib dan Psapi.dll sebagai pembungkus yang memanggil K32QueryWorkingSetEx.

Program yang harus berjalan pada versi Windows yang lebih lama serta Windows 7 dan versi yang lebih baru harus selalu memanggil fungsi ini sebagai QueryWorkingSetEx. Untuk memastikan resolusi simbol yang benar, tambahkan Psapi.lib ke makro TARGETLIBS dan kompilasi program dengan "–DPSAPI_VERSION=1". Untuk menggunakan penautan dinamis run-time, muat Psapi.dll.

Contoh

Misalnya, lihat Mengalokasikan Memori dari Simpul NUMA.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista, Windows XP Professional x64 Edition [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008, Windows Server 2003 dengan SP1 [hanya aplikasi desktop]
Target Platform	Windows
Header	psapi.h
Pustaka	Kernel32.lib pada Windows 7 dan Windows Server 2008 R2; Psapi.lib (jika PSAPI_VERSION=1) pada Windows 7 dan Windows Server 2008 R2; Psapi.lib di Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP
DLL	Kernel32.dll pada Windows 7 dan Windows Server 2008 R2; Psapi.dll (jika PSAPI_VERSION=1) pada Windows 7 dan Windows Server 2008 R2; Psapi.dll pada Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP