Функция CcScheduleReadAheadEx (ntifs.h)

Статья
07/11/2023

Подпрограмма CcScheduleReadAheadEx выполняет упреждающее чтение (также называемое "отложенным чтением") в кэшированном файле. Количество байтов ввода-вывода для операции взимается с выдающего потока.

Синтаксис

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

Параметры

[in] FileObject

Указатель на объект файла, для которого выполняется упреждающее чтение.

[in] FileOffset

Указатель на переменную, указывающую смещение начального байта в кэшированном файле, в котором было выполнено последнее чтение.

[in] Length

Длина в байтах диапазона, который был прочитан последним.

[in] IoIssuerThread

Поток, выдающий запрос на упреждающее чтение. Для файловой системы с включенным учетом дискового ввода-вывода это поток, за который взимается плата за ввод-вывод. Если ioIssuerThread имеет значение NULL, операции ввода-вывода оплачиваются в текущем потоке.

Возвращаемое значение

None

Remarks

CcScheduleReadAheadEx следует вызывать только в том случае, если длина> = 256. Измерения показали, что вызов CcScheduleReadAheadEx для небольших операций чтения фактически снижает производительность.

CcScheduleReadAheadEx можно вызывать только после успешного вызова CcCopyRead, CcCopyReadEx, CcFastCopyRead или CcMdlRead.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8
Целевая платформа	Универсальное
Верхняя часть	ntifs.h (включая Ntifs.h, FltKernel.h)
Библиотека	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL