CcScheduleReadAhead-Funktion (ntifs.h)

Artikel
02/29/2024

Die CcScheduleReadAhead-Routine führt read-ahead (auch als "verzögertes Lesen" bezeichnet) für eine zwischengespeicherte Datei aus. CcScheduleReadAhead sollte niemals direkt aufgerufen werden. Stattdessen sollte das CcReadAhead-Makro aufgerufen werden.

Syntax

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

Parameter

[in] FileObject

Zeiger auf ein Dateiobjekt für die Datei, für die read-ahead ausgeführt werden soll.

[in] FileOffset

Zeiger auf eine Variable, die den Anfangsbyteoffset innerhalb der zwischengespeicherten Datei angibt, in der der letzte Lesevorgang erfolgt ist.

[in] Length

Länge in Byte des Bereichs, der zuletzt gelesen wurde.

Rückgabewert

Keine

Bemerkungen

Das CcReadAhead-Makro ist ein Wrapper für CcScheduleReadAhead. CcScheduleReadAhead wird nur aufgerufen, wenn Length>= 256 ist. Messungen haben gezeigt, dass der Aufruf von CcScheduleReadAhead für kleinere Lesevorgänge tatsächlich die Leistung verringert.

CcReadAhead und CcScheduleReadAhead können nur nach einem erfolgreichen Aufruf von CcCopyRead, CcFastCopyRead oder CcMdlRead aufgerufen werden.