CcScheduleReadAhead, fonction (ntifs.h)

Article
12/21/2024

La routine CcScheduleReadAhead effectue une lecture anticipée (également appelée « lecture différée ») sur un fichier mis en cache. CcScheduleReadAhead ne doit jamais être appelé directement. La macro CcReadAhead doit être appelée à la place.

Syntaxe

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

Paramètres

[in] FileObject

Pointeur vers un objet de fichier pour le fichier sur lequel la lecture anticipée doit être effectuée.

[in] FileOffset

Pointeur vers une variable qui spécifie le décalage d’octets de départ dans le fichier mis en cache où la dernière lecture s’est produite.

[in] Length

Longueur en octets de la plage qui a été la dernière lecture.

Valeur de retour

Aucun

Remarques

La macro ccReadAhead est un wrapper pour CcScheduleReadAhead. Il appelle CcScheduleReadAhead uniquement si Length>= 256. Les mesures ont montré que l’appel CcScheduleReadAhead pour les lectures plus petites diminue réellement les performances.

CcReadAhead et CcScheduleReadAhead ne peut être appelé qu’après un appel réussi à CcCopyRead, CcFastCopyReadou CcMdlRead.