Compartir a través de

Función SetSystemFileCacheSize (memoryapi.h)

  • Artículo

Limita el tamaño del conjunto de trabajo para la memoria caché del sistema de archivos.

Sintaxis

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

Parámetros

[in] MinimumFileCacheSize

Tamaño mínimo de la memoria caché de archivos, en bytes. El administrador de memoria virtual intenta mantener al menos esta cantidad de memoria residente en la caché de archivos del sistema.

Para vaciar la memoria caché, especifique (SIZE_T) -1.

[in] MaximumFileCacheSize

Tamaño máximo de la memoria caché de archivos, en bytes. El administrador de memoria virtual aplica este límite solo si esta llamada o una llamada anterior a SetSystemFileCacheSize especifica FILE_CACHE_MAX_HARD_ENABLE.

Para vaciar la memoria caché, especifique (SIZE_T) -1.

[in] Flags

Marcas que habilitan o deshabilitan los límites de caché de archivos. Si este parámetro es 0 (cero), los límites de tamaño conservan la configuración actual, que está deshabilitada o habilitada.

Valor Significado
FILE_CACHE_MAX_HARD_DISABLE
0x2
 Deshabilite el límite de tamaño máximo.

Las marcas FILE_CACHE_MAX_HARD_DISABLE y FILE_CACHE_MAX_HARD_ENABLE son mutuamente excluyentes.
FILE_CACHE_MAX_HARD_ENABLE
0x1
 Habilite el límite de tamaño máximo.

Las marcas FILE_CACHE_MAX_HARD_DISABLE y FILE_CACHE_MAX_HARD_ENABLE son mutuamente excluyentes.
FILE_CACHE_MIN_HARD_DISABLE
0x8
 Deshabilite el límite de tamaño mínimo.

Las marcas FILE_CACHE_MIN_HARD_DISABLE y FILE_CACHE_MIN_HARD_ENABLE son mutuamente excluyentes.
FILE_CACHE_MIN_HARD_ENABLE
0x4
 Habilite el límite de tamaño mínimo.

Las marcas FILE_CACHE_MIN_HARD_DISABLE y FILE_CACHE_MIN_HARD_ENABLE son mutuamente excluyentes.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un valor distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es 0 (cero). Para obtener información de error extendida, llame a GetLastError.

Comentarios

El proceso de llamada debe habilitar el privilegio SE_INCREASE_QUOTA_NAME .

Establecer el parámetro MaximumFileCacheSize en un valor muy bajo puede afectar negativamente al rendimiento del sistema.

Para compilar una aplicación que usa esta función, defina _WIN32_WINNT como 0x0502 o posterior. Para obtener más información, vea Usar los encabezados de Windows.

Las constantes FILE_CACHE_* se definirán en los archivos de encabezado de Windows a partir de Windows SDK para Windows Server 2008. Si usa archivos de encabezado de una versión anterior del SDK, agregue las siguientes definiciones al código.

#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

Requisitos

   
Cliente mínimo compatible Windows Vista, Windows XP Professional x64 Edition [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008, Windows Server 2003 con SP1 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado memoryapi.h (incluye Windows.h, Memoryapi.h)
Library onecore.lib
Archivo DLL Kernel32.dll

Vea también

GetSystemFileCacheSize

Funciones de administración de memoria