Share via

SetSystemFileCacheSize 함수(memoryapi.h)

  • 아티클

파일 시스템 캐시에 대한 작업 집합의 크기를 제한합니다.

구문

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

매개 변수

[in] MinimumFileCacheSize

파일 캐시의 최소 크기(바이트)입니다. 가상 메모리 관리자는 시스템 파일 캐시에 적어도 이 정도의 메모리를 유지하려고 합니다.

캐시를 플러시하려면 를 지정합니다 (SIZE_T) -1.

[in] MaximumFileCacheSize

파일 캐시의 최대 크기(바이트)입니다. 가상 메모리 관리자는 이 호출 또는 SetSystemFileCacheSize 에 대한 이전 호출이 FILE_CACHE_MAX_HARD_ENABLE 지정하는 경우에만 이 제한을 적용합니다.

캐시를 플러시하려면 를 지정합니다 (SIZE_T) -1.

[in] Flags

파일 캐시 제한을 사용하거나 사용하지 않도록 설정하는 플래그입니다. 이 매개 변수가 0인 경우 크기 제한은 사용 안 함 또는 활성화된 현재 설정을 유지합니다.

값 의미
FILE_CACHE_MAX_HARD_DISABLE
0x2
 최대 크기 제한을 사용하지 않도록 설정합니다.

FILE_CACHE_MAX_HARD_DISABLE 및 FILE_CACHE_MAX_HARD_ENABLE 플래그는 상호 배타적입니다.
FILE_CACHE_MAX_HARD_ENABLE
0x1
 최대 크기 제한을 사용하도록 설정합니다.

FILE_CACHE_MAX_HARD_DISABLE 및 FILE_CACHE_MAX_HARD_ENABLE 플래그는 상호 배타적입니다.
FILE_CACHE_MIN_HARD_DISABLE
0x8
 최소 크기 제한을 사용하지 않도록 설정합니다.

FILE_CACHE_MIN_HARD_DISABLE 및 FILE_CACHE_MIN_HARD_ENABLE 플래그는 상호 배타적입니다.
FILE_CACHE_MIN_HARD_ENABLE
0x4
 최소 크기 제한을 사용하도록 설정합니다.

FILE_CACHE_MIN_HARD_DISABLE 및 FILE_CACHE_MIN_HARD_ENABLE 플래그는 상호 배타적입니다.

반환 값

함수가 성공하면 반환 값은 0이 아닌 값입니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

호출 프로세스는 SE_INCREASE_QUOTA_NAME 권한을 사용하도록 설정해야 합니다.

MaximumFileCacheSize 매개 변수를 매우 낮은 값으로 설정하면 시스템 성능에 부정적인 영향을 줄 수 있습니다.

이 함수를 사용하는 애플리케이션을 컴파일하려면 _WIN32_WINNT 0x0502 이상으로 정의합니다. 자세한 내용은 Windows 헤더 사용을 참조하세요.

FILE_CACHE_* 상수는 Windows Server 2008용 Windows SDK부터 Windows 헤더 파일에 정의됩니다. 이전 버전의 SDK에서 헤더 파일을 사용하는 경우 코드에 다음 정의를 추가합니다.

#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

요구 사항

   
지원되는 최소 클라이언트 Windows Vista, Windows XP Professional x64 Edition [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008, Windows Server 2003 SP1 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 memoryapi.h(Windows.h, Memoryapi.h 포함)
라이브러리 onecore.lib
DLL Kernel32.dll

참고 항목

GetSystemFileCacheSize

메모리 관리 함수