SetSystemFileCacheSize-Funktion (memoryapi.h)

2023-08-24

Schränkt die Größe des Arbeitssatzes für den Dateisystemcache ein.

Syntax

BOOL SetSystemFileCacheSize(
  [in] SIZE_T MinimumFileCacheSize,
  [in] SIZE_T MaximumFileCacheSize,
  [in] DWORD  Flags
);

Parameter

[in] MinimumFileCacheSize

Die Mindestgröße des Dateicaches in Bytes. Der Manager des virtuellen Arbeitsspeichers versucht, mindestens so viel Arbeitsspeicher im Systemdateicache zu speichern.

Geben Sie zum Leeren des Caches an (SIZE_T) -1.

[in] MaximumFileCacheSize

Die maximale Größe des Dateicaches in Bytes. Der Manager des virtuellen Arbeitsspeichers erzwingt diesen Grenzwert nur, wenn dieser Aufruf oder ein vorheriger Aufruf von SetSystemFileCacheSizeFILE_CACHE_MAX_HARD_ENABLE angibt.

Geben Sie zum Leeren des Caches an (SIZE_T) -1.

[in] Flags

Die Flags, die die Dateicachegrenzwerte aktivieren oder deaktivieren. Wenn dieser Parameter 0 (null) ist, behalten die Größenlimits die aktuelle Einstellung bei, die entweder deaktiviert oder aktiviert ist.

Wert	Bedeutung
FILE_CACHE_MAX_HARD_DISABLE 0x2	Deaktivieren Sie die maximale Größenbegrenzung. Die flags FILE_CACHE_MAX_HARD_DISABLE und FILE_CACHE_MAX_HARD_ENABLE schließen sich gegenseitig aus.
FILE_CACHE_MAX_HARD_ENABLE 0x1	Aktivieren Sie die maximale Größenbegrenzung. Die flags FILE_CACHE_MAX_HARD_DISABLE und FILE_CACHE_MAX_HARD_ENABLE schließen sich gegenseitig aus.
FILE_CACHE_MIN_HARD_DISABLE 0x8	Deaktivieren Sie die Mindestgröße. Die flags FILE_CACHE_MIN_HARD_DISABLE und FILE_CACHE_MIN_HARD_ENABLE schließen sich gegenseitig aus.
FILE_CACHE_MIN_HARD_ENABLE 0x4	Aktivieren Sie das Mindestgrößenlimit. Die flags FILE_CACHE_MIN_HARD_DISABLE und FILE_CACHE_MIN_HARD_ENABLE schließen sich gegenseitig aus.

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

Der aufrufende Prozess muss die berechtigung SE_INCREASE_QUOTA_NAME aktivieren.

Das Festlegen des Parameters MaximumFileCacheSize auf einen sehr niedrigen Wert kann sich negativ auf die Systemleistung auswirken.

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 folgenden Definitionen hinzu.

#ifndef FILE_CACHE_FLAGS_DEFINED

#define FILE_CACHE_MAX_HARD_ENABLE      0x00000001
#define FILE_CACHE_MAX_HARD_DISABLE     0x00000002
#define FILE_CACHE_MIN_HARD_ENABLE      0x00000004
#define FILE_CACHE_MIN_HARD_DISABLE     0x00000008

#endif // FILE_CACHE_FLAGS_DEFINED

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

GetSystemFileCacheSize

Speicherverwaltungsfunktionen

Freigeben über