QueryWorkingSetEx-Funktion (psapi.h)

  • Artikel

Ruft erweiterte Informationen zu den Seiten an bestimmten virtuellen Adressen im Adressraum des angegebenen Prozesses ab.

Syntax

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

Parameter

[in] hProcess

Ein Handle für den Prozess. Das Handle muss über das zugriffsrecht PROCESS_QUERY_INFORMATION verfügen. Weitere Informationen finden Sie unter Prozesssicherheit und Zugriffsrechte.

[in, out] pv

Ein Zeiger auf ein Array von PSAPI_WORKING_SET_EX_INFORMATION Strukturen. Bei der Eingabe gibt jedes Element im Array eine interessante virtuelle Adresse an. Bei der Ausgabe empfängt jedes Element im Array Informationen über die entsprechende virtuelle Seite.

[in] cb

Die Größe des pv-Puffers in Bytes.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Im Gegensatz zur QueryWorkingSet-Funktion , die auf den Arbeitssatz des Zielprozesses beschränkt ist, kann die QueryWorkingSetEx-Funktion verwendet werden, um Adressen abzufragen, die sich nicht im Prozessarbeitssatz befinden, aber weiterhin Teil des Prozesses sind, z. B. AWE und große Seiten.

Ab Windows 7 und Windows Server 2008 R2 richtet Psapi.h Versionsnummern für die PSAPI-Funktionen ein. Die PSAPI-Versionsnummer wirkt sich auf den Namen aus, der zum Aufrufen der Funktion und der Bibliothek verwendet wird, die ein Programm laden muss.

Wenn PSAPI_VERSION 2 oder höher ist, wird diese Funktion als K32QueryWorkingSetEx in Psapi.h definiert und in Kernel32.lib und Kernel32.dll exportiert. Wenn PSAPI_VERSION 1 ist, wird diese Funktion als QueryWorkingSetEx in Psapi.h definiert und in Psapi.lib und Psapi.dll als Wrapper exportiert, der K32QueryWorkingSetEx aufruft.

Programme, die unter früheren Versionen von Windows sowie windows 7 und höher ausgeführt werden müssen, sollten diese Funktion immer als QueryWorkingSetEx aufrufen. Um die richtige Auflösung von Symbolen sicherzustellen, fügen Sie dem TARGETLIBS-Makro Psapi.lib hinzu, und kompilieren Sie das Programm mit "–DPSAPI_VERSION=1". Laden Sie Psapi.dll, um dynamische Laufzeitverknüpfung zu verwenden.

Beispiele

Ein Beispiel finden Sie unter Zuweisen von Arbeitsspeicher über einen NUMA-Knoten.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista, Windows XP Professional x64 Edition [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008, Windows Server 2003 mit SP1 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile psapi.h
Bibliothek Kernel32.lib unter Windows 7 und Windows Server 2008 R2; Psapi.lib (wenn PSAPI_VERSION=1) unter Windows 7 und Windows Server 2008 R2; Psapi.lib unter Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP
DLL Kernel32.dll unter Windows 7 und Windows Server 2008 R2; Psapi.dll (wenn PSAPI_VERSION=1) unter Windows 7 und Windows Server 2008 R2; Psapi.dll unter Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP

Weitere Informationen

EnumProcesses

PSAPI-Funktionen

PSAPI_WORKING_SET_EX_INFORMATION

Arbeitssatzinformationen