Fungsi CcCopyWriteEx (ntifs.h)

  • Artikel

CcCopyWriteEx rutin menyalin data dari buffer pengguna ke file cache. Jumlah byte I/O untuk operasi dibebankan ke utas penerbit.

Sintaks

BOOLEAN CcCopyWriteEx(
  [in] PFILE_OBJECT   FileObject,
  [in] PLARGE_INTEGER FileOffset,
  [in] ULONG          Length,
  [in] BOOLEAN        Wait,
  [in] PVOID          Buffer,
  [in] PETHREAD       IoIssuerThread
);

Parameter

[in] FileObject

Penunjuk ke objek file untuk file cache tempat data akan ditulis.

[in] FileOffset

Penunjuk ke variabel yang menentukan offset byte awal dalam file yang di-cache.

[in] Length

Panjang byte data yang akan ditulis.

[in] Wait

Atur ke TRUE jika penelepon dapat dimasukkan ke dalam status tunggu hingga semua data telah disalin, FALSE jika tidak.

[in] Buffer

Penunjuk ke buffer tempat data akan disalin.

[in] IoIssuerThread

Utas yang mengeluarkan permintaan tulis. Untuk sistem file dengan akuntansi I/O disk diaktifkan, ini adalah utas yang dikenakan biaya I/O. Jika IoIssuerThread adalah NULL, I/O dibebankan ke utas saat ini.

Mengembalikan nilai

Rutinitas CcCopyWriteEx mengembalikan TRUE jika data berhasil disalin, FALSE jika tidak.

Keterangan

Jika Wait is TRUE, CcCopyWriteEx dijamin untuk menyelesaikan permintaan salin dan mengembalikan TRUE. Jika halaman yang diperlukan dari file yang di-cache sudah berada dalam memori, data akan segera disalin dan tidak ada pemblokiran yang akan terjadi. Jika ada halaman yang diperlukan tidak residen, penelepon akan dimasukkan ke dalam status tunggu sampai semua halaman yang diperlukan telah dibuat residen dan data dapat disalin.

Jika Wait is FALSE, CcCopyWriteEx akan menolak untuk memblokir, dan akan mengembalikan FALSE, jika halaman yang diperlukan dari file yang di-cache belum berada dalam memori atau jika bendera FO_WRITE_THROUGH diatur pada objek file.

Jika terjadi kegagalan, CcCopyWriteEx menimbulkan pengecualian status untuk kegagalan tertentu tersebut. Misalnya, jika kegagalan alokasi kumpulan terjadi, CcCopyWriteEx menimbulkan pengecualian dengan status STATUS_INSUFFICIENT_RESOURCES ; jika terjadi kesalahan I/O, CcCopyWriteEx menaikkan pengecualian status kesalahan I/O. Oleh karena itu, untuk mendapatkan kontrol jika kegagalan terjadi, driver harus membungkus panggilan ke CcCopyWriteEx dalam pernyataan try-except atau try-finally .

Untuk membuat cache file, gunakan CcInitializeCacheMap.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 8
Target Platform Universal
Header ntifs.h (termasuk Ntifs.h, FltKernel.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

Lihat juga

CcInitializeCacheMap