Funzione CcScheduleReadAheadEx (ntifs.h)

Articolo
02/26/2024

La routine CcScheduleReadAheadEx esegue il read-ahead (detto anche "lettura differita") in un file memorizzato nella cache. Il conteggio dei byte di I/O per l'operazione viene addebitato al thread emittente.

Sintassi

void CcScheduleReadAheadEx(
  [in] PFILE_OBJECT   FileObject,
  [in] PLARGE_INTEGER FileOffset,
  [in] ULONG          Length,
  [in] PETHREAD       IoIssuerThread
);

Parametri

[in] FileObject

Puntatore a un oggetto file per il file in cui deve essere eseguito read-ahead.

[in] FileOffset

Puntatore a una variabile che specifica l'offset di byte iniziale all'interno del file memorizzato nella cache in cui si è verificata l'ultima lettura.

[in] Length

Lunghezza in byte dell'intervallo dell'ultima lettura.

[in] IoIssuerThread

Thread che emette la richiesta read ahead. Per un file system con contabilità di I/O su disco abilitata, questo è il thread a cui viene addebitato l'I/O. Se IoIssuerThread è NULL, l'I/O viene addebitato al thread corrente.

Valore restituito

nessuno

Osservazioni

CcScheduleReadAheadEx deve essere chiamato solo quando Length>= 256. Le misurazioni hanno dimostrato che la chiamata a CcScheduleReadAheadEx per letture più piccole riduce effettivamente le prestazioni.

CcScheduleReadAheadEx può essere chiamato solo dopo una chiamata riuscita a CcCopyRead, CcCopyReadEx, CcFastCopyRead o CcMdlRead.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8
Piattaforma di destinazione	Universale
Intestazione	ntifs.h (include Ntifs.h, FltKernel.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL