Fungsi CcScheduleReadAheadEx (ntifs.h)

Artikel
02/29/2024

Rutinitas CcScheduleReadAheadEx melakukan read-ahead (juga disebut "malas baca") pada file yang di-cache. Jumlah byte I/O untuk operasi dibebankan ke utas penerbit.

Sintaks

void CcScheduleReadAheadEx(
  [in] PFILE_OBJECT   FileObject,
  [in] PLARGE_INTEGER FileOffset,
  [in] ULONG          Length,
  [in] PETHREAD       IoIssuerThread
);

Parameter

[in] FileObject

Penunjuk ke objek file untuk file tempat read-ahead akan dilakukan.

[in] FileOffset

Penunjuk ke variabel yang menentukan offset byte awal dalam file yang di-cache tempat pembacaan terakhir terjadi.

[in] Length

Panjang dalam byte rentang yang terakhir dibaca.

[in] IoIssuerThread

Utas yang mengeluarkan permintaan baca di depan. 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.

Nilai kembali

Tidak ada

Keterangan

CcScheduleReadAheadEx harus dipanggil hanya ketika Length>= 256. Pengukuran telah menunjukkan bahwa memanggil CcScheduleReadAheadEx untuk pembacaan yang lebih kecil benar-benar mengurangi performa.

CcScheduleReadAheadEx hanya dapat dipanggil setelah panggilan berhasil ke CcCopyRead, CcCopyReadEx, CcFastCopyRead, atau CcMdlRead.

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