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

Статья
12/21/2024

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

Синтаксис

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

Параметры

[in] FileObject

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

[in] FileOffset

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

[in] Length

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

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

Никакой

Замечания

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

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

Требования

Требование	Ценность
целевая платформа	Всеобщий
заголовка	ntifs.h (include Ntifs.h)
библиотеки	NtosKrnl.lib
DLL	NtosKrnl.exe