CcSetReadAheadGranularity function (ntifs.h)

Article
02/22/2024

The CcSetReadAheadGranularity routine sets the read-ahead granularity for a cached file.

Syntax

void CcSetReadAheadGranularity(
  [in] PFILE_OBJECT FileObject,
  [in] ULONG        Granularity
);

Parameters

[in] FileObject

Pointer to a file object for the cached file whose read-ahead granularity is to be set.

[in] Granularity

Specifies the desired read-ahead granularity, which must be an even power of two and must be greater than or equal to PAGE_SIZE.

Return value

None

Remarks

After CcInitializeCacheMap is called to cache a file, but before CcSetReadAheadGranularity is called for the cached file, the default read-ahead granularity for the cached file is equal to PAGE_SIZE.

Requirements

Requirement	Value
Target Platform	Universal
Header	ntifs.h (include Ntifs.h)
Library	NtosKrnl.lib
DLL	NtosKrnl.exe