Funzione SetSystemFileCacheSize (memoryapi.h)

Articolo
08/24/2023

Limita le dimensioni del working set per la cache del file system.

Sintassi

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

Parametri

[in] MinimumFileCacheSize

Dimensioni minime della cache dei file, in byte. Il gestore di memoria virtuale tenta di mantenere almeno questa quantità di memoria residente nella cache dei file di sistema.

Per scaricare la cache, specificare (SIZE_T) -1.

[in] MaximumFileCacheSize

Dimensioni massime della cache dei file, in byte. Gestione memoria virtuale applica questo limite solo se questa chiamata o una chiamata precedente a SetSystemFileCacheSize specifica FILE_CACHE_MAX_HARD_ENABLE.

Per scaricare la cache, specificare (SIZE_T) -1.

[in] Flags

Flag che abilitano o disabilitano i limiti della cache dei file. Se questo parametro è 0 (zero), i limiti delle dimensioni mantengono l'impostazione corrente, disabilitata o abilitata.

Valore	Significato
FILE_CACHE_MAX_HARD_DISABLE 0x2	Disabilitare il limite massimo di dimensioni. I flag FILE_CACHE_MAX_HARD_DISABLE e FILE_CACHE_MAX_HARD_ENABLE si escludono a vicenda.
FILE_CACHE_MAX_HARD_ENABLE 0x1	Abilitare il limite massimo di dimensioni. I flag FILE_CACHE_MAX_HARD_DISABLE e FILE_CACHE_MAX_HARD_ENABLE si escludono a vicenda.
FILE_CACHE_MIN_HARD_DISABLE 0x8	Disabilitare il limite minimo di dimensioni. I flag FILE_CACHE_MIN_HARD_DISABLE e FILE_CACHE_MIN_HARD_ENABLE si escludono a vicenda.
FILE_CACHE_MIN_HARD_ENABLE 0x4	Abilitare il limite minimo di dimensioni. I flag FILE_CACHE_MIN_HARD_DISABLE e FILE_CACHE_MIN_HARD_ENABLE si escludono a vicenda.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un valore diverso da zero.

Se la funzione ha esito negativo, il valore restituito è 0 (zero). Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Il processo chiamante deve abilitare il privilegio SE_INCREASE_QUOTA_NAME .

L'impostazione del parametro MaximumFileCacheSize su un valore molto basso può influire negativamente sulle prestazioni del sistema.

Per compilare un'applicazione che usa questa funzione, definire _WIN32_WINNT come 0x0502 o versione successiva. Per altre informazioni, vedere Uso delle intestazioni di Windows.

Le costanti FILE_CACHE_* verranno definite nei file di intestazione di Windows a partire da Windows SDK per Windows Server 2008. Se si usano file di intestazione di una versione precedente dell'SDK, aggiungere le definizioni seguenti al codice.

#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

Requisiti


Client minimo supportato	Windows Vista, Windows XP Professional x64 Edition [solo app desktop]
Server minimo supportato	Windows Server 2008, Windows Server 2003 con SP1 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	memoryapi.h (include Windows.h, Memoryapi.h)
Libreria	onecore.lib
DLL	Kernel32.dll

Vedere anche

GetSystemFileCacheSize

Funzioni di gestione della memoria

Condividi tramite