Fungsi SetSystemFileCacheSize (memoryapi.h)

Artikel
08/24/2023

Membatasi ukuran set kerja untuk cache sistem file.

Sintaks

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

Parameter

[in] MinimumFileCacheSize

Ukuran minimum cache file, dalam byte. Manajer memori virtual mencoba untuk menyimpan setidaknya memori sebanyak ini dalam cache file sistem.

Untuk menghapus cache, tentukan (SIZE_T) -1.

[in] MaximumFileCacheSize

Ukuran maksimum cache file, dalam byte. Manajer memori virtual memberlakukan batas ini hanya jika panggilan ini atau panggilan sebelumnya ke SetSystemFileCacheSize menentukan FILE_CACHE_MAX_HARD_ENABLE.

Untuk menghapus cache, tentukan (SIZE_T) -1.

[in] Flags

Bendera yang mengaktifkan atau menonaktifkan batas cache file. Jika parameter ini adalah 0 (nol), batas ukuran mempertahankan pengaturan saat ini, yang dinonaktifkan atau diaktifkan.

Nilai	Makna
FILE_CACHE_MAX_HARD_DISABLE 0x2	Nonaktifkan batas ukuran maksimum. Bendera FILE_CACHE_MAX_HARD_DISABLE dan FILE_CACHE_MAX_HARD_ENABLE saling eksklusif.
FILE_CACHE_MAX_HARD_ENABLE 0x1	Aktifkan batas ukuran maksimum. Bendera FILE_CACHE_MAX_HARD_DISABLE dan FILE_CACHE_MAX_HARD_ENABLE saling eksklusif.
FILE_CACHE_MIN_HARD_DISABLE 0x8	Nonaktifkan batas ukuran minimum. Bendera FILE_CACHE_MIN_HARD_DISABLE dan FILE_CACHE_MIN_HARD_ENABLE saling eksklusif.
FILE_CACHE_MIN_HARD_ENABLE 0x4	Aktifkan batas ukuran minimum. Bendera FILE_CACHE_MIN_HARD_DISABLE dan FILE_CACHE_MIN_HARD_ENABLE saling eksklusif.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah nilai bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah 0 (nol). Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Proses panggilan harus mengaktifkan hak istimewa SE_INCREASE_QUOTA_NAME .

Mengatur parameter MaximumFileCacheSize ke nilai yang sangat rendah dapat berdampak buruk pada performa sistem.

Untuk mengkompilasi aplikasi yang menggunakan fungsi ini, tentukan _WIN32_WINNT sebagai 0x0502 atau yang lebih baru. Untuk informasi selengkapnya, lihat Menggunakan Header Windows.

Konstanta FILE_CACHE_* akan ditentukan dalam file header Windows yang dimulai dengan Windows SDK untuk Windows Server 2008. Jika Anda menggunakan file header dari versi SDK yang lebih lama, tambahkan definisi berikut ke kode Anda.

#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

Persyaratan


Klien minimum yang didukung	Windows Vista, Windows XP Professional x64 Edition [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008, Windows Server 2003 dengan SP1 [hanya aplikasi desktop]
Target Platform	Windows
Header	memoryapi.h (termasuk Windows.h, Memoryapi.h)
Pustaka	onecore.lib
DLL	Kernel32.dll

Lihat juga

GetSystemFileCacheSize

Fungsi Manajemen Memori

Share via