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

Статья
12/20/2024

Подпрограмма 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, ввод-вывод взимается в текущий поток.

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

Никакой

Замечания

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

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 8
целевая платформа	Всеобщий
заголовка	ntifs.h (include Ntifs.h, FltKernel.h)
библиотеки	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL