GetSystemFileCacheSize-Funktion (memoryapi.h)

Artikel
08/24/2023

Ruft die aktuellen Größenbeschränkungen für den Arbeitssatz des Systemcaches ab.

Syntax

BOOL GetSystemFileCacheSize(
  [out] PSIZE_T lpMinimumFileCacheSize,
  [out] PSIZE_T lpMaximumFileCacheSize,
  [out] PDWORD  lpFlags
);

Parameter

[out] lpMinimumFileCacheSize

Ein Zeiger auf eine Variable, die die Mindestgröße des Dateicaches in Bytes empfängt. Der Manager des virtuellen Arbeitsspeichers versucht, mindestens so viel Arbeitsspeicher im Systemdateicache zu speichern, wenn ein vorheriger Aufruf der SetSystemFileCacheSize-Funktion mit dem flag FILE_CACHE_MIN_HARD_ENABLE vorhanden ist.

[out] lpMaximumFileCacheSize

Ein Zeiger auf eine Variable, die die maximale Größe des Dateicaches in Bytes empfängt. Der Virtuelle Speicher-Manager erzwingt diesen Grenzwert nur, wenn ein vorheriger Aufruf von SetSystemFileCacheSize mit dem flag FILE_CACHE_MAX_HARD_ENABLE vorhanden ist.

[out] lpFlags

Die Flags, die angeben, welche der Dateicachegrenzwerte aktiviert sind.

Wert	Bedeutung
FILE_CACHE_MAX_HARD_ENABLE 0x1	Die maximale Größenbegrenzung ist aktiviert. Wenn dieses Flag nicht vorhanden ist, ist dieses Limit deaktiviert.
FILE_CACHE_MIN_HARD_ENABLE 0x4	Die Mindestgröße ist aktiviert. Wenn dieses Flag nicht vorhanden ist, ist dieses Limit deaktiviert.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Nichtzero-Wert.

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

Hinweise

Um eine Anwendung zu kompilieren, die diese Funktion verwendet, definieren Sie _WIN32_WINNT als 0x0502 oder höher. Weitere Informationen finden Sie unter Verwenden der Windows-Header.

Die FILE_CACHE Konstanten werden ab dem Windows SDK für Windows Server 2008 in den Windows-Headerdateien definiert. Wenn Sie Headerdateien aus einer früheren Version des SDK verwenden, fügen Sie dem Code die definitionen hinzu, die in SetSystemFileCacheSize angezeigt werden.

Anforderungen


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	memoryapi.h (einschließlich Windows.h, Memoryapi.h)
Bibliothek	onecore.lib
DLL	Kernel32.dll

Siehe auch

Speicherverwaltungsfunktionen

SetSystemFileCacheSize

Freigeben über