SetSystemFileCacheSize, fonction (memoryapi.h)

Article
08/24/2023

Limite la taille du jeu de travail pour le cache du système de fichiers.

Syntaxe

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

Paramètres

[in] MinimumFileCacheSize

Taille minimale du cache de fichiers, en octets. Le gestionnaire de mémoire virtuelle tente de conserver au moins cette quantité de mémoire résidant dans le cache de fichiers système.

Pour vider le cache, spécifiez (SIZE_T) -1.

[in] MaximumFileCacheSize

Taille maximale du cache de fichiers, en octets. Le gestionnaire de mémoire virtuelle applique cette limite uniquement si cet appel ou un appel précédent à SetSystemFileCacheSize spécifie FILE_CACHE_MAX_HARD_ENABLE.

Pour vider le cache, spécifiez (SIZE_T) -1.

[in] Flags

Indicateurs qui activent ou désactivent les limites du cache de fichiers. Si ce paramètre est égal à 0 (zéro), les limites de taille conservent le paramètre actuel, qui est désactivé ou activé.

Valeur	Signification
FILE_CACHE_MAX_HARD_DISABLE 0x2	Désactivez la limite de taille maximale. Les indicateurs FILE_CACHE_MAX_HARD_DISABLE et FILE_CACHE_MAX_HARD_ENABLE s’excluent mutuellement.
FILE_CACHE_MAX_HARD_ENABLE 0x1	Activez la limite de taille maximale. Les indicateurs FILE_CACHE_MAX_HARD_DISABLE et FILE_CACHE_MAX_HARD_ENABLE s’excluent mutuellement.
FILE_CACHE_MIN_HARD_DISABLE 0x8	Désactivez la limite de taille minimale. Les indicateurs FILE_CACHE_MIN_HARD_DISABLE et FILE_CACHE_MIN_HARD_ENABLE s’excluent mutuellement.
FILE_CACHE_MIN_HARD_ENABLE 0x4	Activez la limite de taille minimale. Les indicateurs FILE_CACHE_MIN_HARD_DISABLE et FILE_CACHE_MIN_HARD_ENABLE s’excluent mutuellement.

Valeur retournée

Si la fonction réussit, la valeur de retour est une valeur différente de zéro.

Si la fonction échoue, la valeur de retour est zéro (0). Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Notes

Le processus appelant doit activer le privilège SE_INCREASE_QUOTA_NAME .

La définition du paramètre MaximumFileCacheSize sur une valeur très faible peut nuire aux performances du système.

Pour compiler une application qui utilise cette fonction, définissez _WIN32_WINNT comme 0x0502 ou version ultérieure. Pour plus d’informations, consultez Utilisation des en-têtes Windows.

Les constantes FILE_CACHE_* sont définies dans les fichiers d’en-tête Windows à partir du Kit de développement logiciel (SDK) Windows pour Windows Server 2008. Si vous utilisez des fichiers d’en-tête d’une version antérieure du SDK, ajoutez les définitions suivantes à votre code.

#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

Spécifications


Client minimal pris en charge	Windows Vista, Windows XP Professionnel Édition x64 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008, Windows Server 2003 avec SP1 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	memoryapi.h (inclure Windows.h, Memoryapi.h)
Bibliothèque	onecore.lib
DLL	Kernel32.dll

Voir aussi

GetSystemFileCacheSize

Fonctions de gestion de la mémoire

Partager via