CcScheduleReadAhead - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers
// ntifs.h

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

View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Windows Driver Kit DDI reference (nf-ntifs-ccschedulereadahead)

CcScheduleReadAhead function

Description

The CcScheduleReadAhead routine performs read-ahead (also called "lazy read") on a cached file. CcScheduleReadAhead should never be called directly. The CcReadAhead macro should be called instead.

Parameters

FileObject [in]

Pointer to a file object for the file on which read-ahead is to be performed.

FileOffset [in]

Pointer to a variable that specifies the starting byte offset within the cached file where the last read occurred.

Length [in]

Length in bytes of the range that was last read.

Remarks

The CcReadAhead macro is a wrapper for CcScheduleReadAhead. It calls CcScheduleReadAhead only if Length >= 256. Measurements have shown that calling CcScheduleReadAhead for smaller reads actually decreases performance.

CcReadAhead and CcScheduleReadAhead can only be called after a successful call to CcCopyRead, CcFastCopyRead, or CcMdlRead.

See also

CcCopyRead

CcFastCopyRead

CcMdlRead

CcScheduleReadAhead

CcSetAdditionalCacheAttributes

CcSetReadAheadGranularity