CcScheduleReadAheadEx 函数 (ntifs.h)

项目
02/26/2024

CcScheduleReadAheadEx 例程对缓存文件执行预读 (也称为“延迟读取”) 。操作的 I/O 字节计数将计入发出线程。

语法

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

参数

[in] FileObject

指向要对其执行预读的文件的文件对象的指针。

[in] FileOffset

指向变量的指针，该变量指定发生上次读取的缓存文件中的起始字节偏移量。

[in] Length

上次读取的范围长度（以字节为单位）。

[in] IoIssuerThread

发出提前读取请求的线程。对于启用了磁盘 I/O 记帐的文件系统，这是向 I/O 收费的线程。如果 IoIssuerThread 为 NULL，则 I/O 会向当前线程收费。

返回值

无

备注

仅当 Length>= 256 时，才应调用 CcScheduleReadAheadEx。度量表明，为较小的读取调用 CcScheduleReadAheadEx 实际上会降低性能。

只有在成功调用 CcCopyRead、CcCopyReadEx、CcFastCopyRead 或 CcMdlRead 后，才能调用 CcScheduleReadAheadEx。

要求

要求	值
最低受支持的客户端	Windows 8
目标平台	通用
标头	ntifs.h (包括 Ntifs.h、FltKernel.h)
Library	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL