SetSystemFileCacheSize, fonction (memoryapi.h)

  • Article

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