Función SetSystemFileCacheSize (memoryapi.h)

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 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

Vea también

GetSystemFileCacheSize

Funciones de administración de memoria