GetProcessWorkingSetSizeEx-Funktion (memoryapi.h)

Artikel
08/24/2023

Ruft die minimalen und maximalen Arbeitssatzgrößen des angegebenen Prozesses ab.

Syntax

BOOL GetProcessWorkingSetSizeEx(
  [in]  HANDLE  hProcess,
  [out] PSIZE_T lpMinimumWorkingSetSize,
  [out] PSIZE_T lpMaximumWorkingSetSize,
  [out] PDWORD  Flags
);

Parameter

[in] hProcess

Ein Handle für den Prozess, dessen Arbeitssatzgrößen abgerufen werden. Das Handle muss über das PROCESS_QUERY_INFORMATION - oder PROCESS_QUERY_LIMITED_INFORMATION-Zugriffsrecht verfügen. Weitere Informationen finden Sie unter Prozesssicherheit und Zugriffsrechte.

Windows Server 2003: Das Handle muss über das Zugriffsrecht PROCESS_QUERY_INFORMATION verfügen.

[out] lpMinimumWorkingSetSize

Ein Zeiger auf eine Variable, die die minimale Arbeitssatzgröße des angegebenen Prozesses in Byte empfängt. Der Virtuelle Speicher-Manager versucht, mindestens so viel Arbeitsspeicher im Prozess zu behalten, wenn der Prozess aktiv ist.

[out] lpMaximumWorkingSetSize

Ein Zeiger auf eine Variable, die die maximale Arbeitssatzgröße des angegebenen Prozesses in Byte empfängt. Der Virtuelle Speicher-Manager versucht, nicht mehr als so viel Arbeitsspeicher im Prozess zu behalten, wenn der Prozess aktiv ist, wenn der Arbeitsspeicher knapp ist.

[out] Flags

Die Flags, die die Erzwingung der minimalen und maximalen Arbeitssatzgrößen steuern.

Wert	Bedeutung
QUOTA_LIMITS_HARDWS_MIN_DISABLE 0x00000002	Der Arbeitssatz kann unter die Mindestgrenze des Arbeitssatzes fallen, wenn der Arbeitsspeicherbedarf hoch ist.
QUOTA_LIMITS_HARDWS_MIN_ENABLE 0x00000001	Der Arbeitssatz fällt nicht unter den Mindestarbeitssatzgrenzwert.
QUOTA_LIMITS_HARDWS_MAX_DISABLE 0x00000008	Der Arbeitssatz kann den maximalen Arbeitssatzgrenzwert überschreiten, wenn genügend Arbeitsspeicher vorhanden ist.
QUOTA_LIMITS_HARDWS_MAX_ENABLE 0x00000004	Der Arbeitssatz überschreitet den maximalen Arbeitssatzgrenzwert nicht.

Rückgabewert

Keine

Bemerkungen

Der "Arbeitssatz" eines Prozesses ist der Satz von Speicherseiten, die für den Prozess derzeit im physischen RAM-Speicher sichtbar sind. Diese Seiten sind resident und können von einer Anwendung verwendet werden, ohne dass ein Seitenfehler ausgelöst wird. Die minimale Größe und die maximale Größe von Arbeitssätzen wirken sich auf das Verhalten beim Auslagern des virtuellen Arbeitsspeichers für einen Prozess aus.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	memoryapi.h (enthalten Windows.h unter Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Bibliothek	onecore.lib
DLL	Kernel32.dll

Siehe auch

Prozess – Arbeitssatz

Prozesse

SetProcessWorkingSetSizeEx