Fungsi CcSetCacheFileSizes (ntifs.h)

  • Artikel

Fungsi CcSetCacheFileSizes mengatur ukuran file manajer cache menurut penunjuk objek bagian.

Sintaks

NTSTATUS CcSetCacheFileSizes(
  [in] PSECTION_OBJECT_POINTERS SectionObjectPointer,
  [in] PCC_FILE_SIZES           FileSizes
);

Parameter

[in] SectionObjectPointer

Penunjuk ke struktur SECTION_OBJECT_POINTERS yang berisi informasi objek bagian.

[in] FileSizes

Penunjuk ke struktur CC_FILE_SIZES yang menentukan ukuran file yang akan diatur.

Nilai kembali

CcSetCacheFileSizes mengembalikan STATUS_SUCCESS jika ukuran file berhasil diubah, dan, jika pembersihan diperlukan bahwa pembersihan berhasil. Jika tidak, kode NSTATUS yang tidak berhasil akan dikembalikan seperti STATUS_INSUFFICIENT_RESOURCES, dan mungkin menaikkan pengecualian status.

Mengenai menaikkan pengecualian status pada kesalahan:

  • Jika operasi menyebabkan CcSetCacheFileSizes membersihkan dan/atau menghapus menyeluruh file, CcSetCacheFileSizes tidak akan muncul pada kesalahan; itu hanya mengembalikan kode NTSTATUS yang tidak berhasil yang sesuai dari operasi pembersihan atau pembersihan.

  • Jika operasi menyebabkan CcSetCacheFileSizes memperluas bagian, maka CcSetCacheFileSizes akan memunculkan kesalahan apa pun yang ditemuinya selama ekstensi ini.

Keterangan

Jika operasi menyebabkan CcSetCacheFileSizes memperluas bagian dan kegagalan terjadi, CcSetCacheFileSizes menimbulkan pengecualian status untuk kegagalan tertentu tersebut. Misalnya, jika kegagalan alokasi kumpulan terjadi, CcSetCacheFileSizes menimbulkan pengecualian STATUS_INSUFFICIENT_RESOURCES. Oleh karena itu, untuk mendapatkan kontrol jika kegagalan terjadi, driver harus membungkus panggilan ke CcSetCacheFileSizes dalam pernyataan try-except atau try-finally .

Sistem file harus memastikan bahwa peta cache valid dan akan tetap demikian selama durasi panggilan ini.

Untuk mendapatkan ukuran file yang di-cache, lewati SectionObjectPointer ke CcGetCacheFileSize.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 11, versi 22H2
Header ntifs.h

Lihat juga

CcGetCacheFileSize

CcSetFileSizesEx