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

Статья
08/07/2023

Подпрограмма CcScheduleReadAhead выполняет упреждающее чтение (также называемое "отложенным чтением") в кэшированном файле. CcScheduleReadAhead никогда не следует вызывать напрямую. Вместо этого следует вызвать макрос CcReadAhead .

Синтаксис

void CcScheduleReadAhead(
  [in] PFILE_OBJECT   FileObject,
  [in] PLARGE_INTEGER FileOffset,
  [in] ULONG          Length
);

Параметры

[in] FileObject

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

[in] FileOffset

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

[in] Length

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

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

None

Remarks

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

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

Требования

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