Função GetSystemFileCacheSize (memoryapi.h)

  • Artigo

Recupera os limites de tamanho atuais para o conjunto de trabalho do cache do sistema.

Sintaxe

BOOL GetSystemFileCacheSize(
  [out] PSIZE_T lpMinimumFileCacheSize,
  [out] PSIZE_T lpMaximumFileCacheSize,
  [out] PDWORD  lpFlags
);

Parâmetros

[out] lpMinimumFileCacheSize

Um ponteiro para uma variável que recebe o tamanho mínimo do cache de arquivos, em bytes. O gerenciador de memória virtual tentará manter pelo menos essa quantidade de memória residente no cache de arquivos do sistema, se houver uma chamada anterior para a função SetSystemFileCacheSize com o sinalizador FILE_CACHE_MIN_HARD_ENABLE .

[out] lpMaximumFileCacheSize

Um ponteiro para uma variável que recebe o tamanho máximo do cache de arquivos, em bytes. O gerenciador de memória virtual impõe esse limite somente se houver uma chamada anterior para SetSystemFileCacheSize com o sinalizador FILE_CACHE_MAX_HARD_ENABLE .

[out] lpFlags

Os sinalizadores que indicam quais dos limites de cache de arquivo estão habilitados.

Valor Significado
FILE_CACHE_MAX_HARD_ENABLE
0x1
 O limite de tamanho máximo está habilitado. Se esse sinalizador não estiver presente, esse limite será desabilitado.
FILE_CACHE_MIN_HARD_ENABLE
0x4
 O limite de tamanho mínimo está habilitado. Se esse sinalizador não estiver presente, esse limite será desabilitado.

Valor retornado

Se a função for bem-sucedida, o valor retornado será um valor diferente de zero.

Se a função falhar, o valor retornado será zero (0). Para obter informações de erro estendidas, chame GetLastError.

Comentários

Para compilar um aplicativo que usa essa função, defina _WIN32_WINNT como 0x0502 ou posterior. Para obter mais informações, consulte Usando os cabeçalhos do Windows.

As constantes FILE_CACHE serão definidas nos arquivos de cabeçalho do Windows, começando com o SDK do Windows para Windows Server 2008. Se você estiver usando arquivos de cabeçalho de uma versão anterior do SDK, adicione as definições mostradas em SetSystemFileCacheSize ao seu código.

Requisitos

   
Cliente mínimo com suporte Windows Vista, Windows XP Professional x64 Edition [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008, Windows Server 2003 com SP1 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho memoryapi.h (inclua Windows.h, Memoryapi.h)
Biblioteca onecore.lib
DLL Kernel32.dll

Confira também

Funções de gerenciamento da memória

SetSystemFileCacheSize